diff --git a/.github/config/lychee.toml b/.github/config/lychee.toml
index e6f970ae..252914f6 100644
--- a/.github/config/lychee.toml
+++ b/.github/config/lychee.toml
@@ -9,7 +9,22 @@ max_concurrency = 4
 # Check link anchors
 include_fragments = true
 
+# Include additional file types beyond the default markdown/HTML
+include = [
+  "**/*.md",
+  "**/*.java",
+  "**/*.yml"
+]
+
+remap = [
+  # workaround for https://github.com/lycheeverse/lychee/issues/1729
+  "https://github.com/(.*?)/(.*?)/blob/(.*?)/(.*#.*)$ https://raw.githubusercontent.com/$1/$2/$3/$4",
+  "https://docs.oracle.com/(.*)#.*$ https://docs.oracle.com/$1"
+]
+
 exclude = [
+  # workaround for https://github.com/lycheeverse/lychee/issues/1729
+  '^https://github.com/.*#issuecomment-.*$',
   "^http://localhost:",
   "^http://0.0.0.0:",
 ]
diff --git a/mise.toml b/mise.toml
index b8e424c7..f09f5744 100644
--- a/mise.toml
+++ b/mise.toml
@@ -1,5 +1,5 @@
 [tools]
-lychee = "0.18.1"
+lychee = "0.20.1"
 
 [tasks.link-check]
 run = 'lychee --verbose --config .github/config/lychee.toml .'