Add alternate links to crawlable Markdown versions of pages

thibaudcolas · thibaudcolas · commit 1ea5e7dec100 · 2026-01-05T12:46:29.000Z
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block extrahead %}
+  {{ super() }}
+  {%- if page -%}
+    <link rel="alternate" type="text/markdown; charset=utf-8" href="{{ page.canonical_url }}index.md">
+  {%- endif -%}
+{% endblock %}
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -12,6 +12,7 @@ theme:
     primary: indigo
   logo: images/logo.svg
   favicon: images/favicon.png
+  custom_dir: docs/overrides
 markdown_extensions:
   - codehilite
   - admonition
