From 95d38aabfe6a9a7f9b1582fd0023507a4f300cb4 Mon Sep 17 00:00:00 2001
From: Abdon Pijpelink <abdon.pijpelink@qdrant.com>
Date: Wed, 1 Apr 2026 17:14:26 +0200
Subject: [PATCH] Improve Markdown autodiscovery (#2186)

* Add HTTP response header

* Add HTML <head> link

* Add 'View as Markdown' link
---
 netlify.toml                                                | 1 +
 .../themes/qdrant-2024/layouts/partials/head.html           | 4 ++++
 .../qdrant-2024/layouts/partials/table-of-contents.html     | 6 ++++++
 .../themes/qdrant-2024/static/icons/outline/markdown.svg    | 4 ++++
 4 files changed, 15 insertions(+)
 create mode 100644 qdrant-landing/themes/qdrant-2024/static/icons/outline/markdown.svg

diff --git a/netlify.toml b/netlify.toml
index 2e4b3cd5b..575a197a7 100644
--- a/netlify.toml
+++ b/netlify.toml
@@ -33,6 +33,7 @@ HUGO_PARAMS_onetrustScriptId = "0196246a-3663-7350-9a45-b65f645d6314"
     [headers.values]
         X-Content-Type-Options = "nosniff"
         X-Frame-Options = "DENY"
+        Link = '<index.md>; rel="alternate"; type="text/markdown"'
 
 [[headers]]
     for = "/web-ui-info.json"
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/partials/head.html b/qdrant-landing/themes/qdrant-2024/layouts/partials/head.html
index eff30311f..82330b00b 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/partials/head.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/partials/head.html
@@ -53,6 +53,10 @@
     <link href="{{ .RelPermalink }}" rel="feed" type="{{ .MediaType.Type }}" title="{{ $.Site.Title }}" />
   {{ end }}
 
+  {{ with .OutputFormats.Get "Markdown" }}
+    <link rel="alternate" type="{{ .MediaType.Type }}" href="{{ .Permalink }}" title="{{ $.Page.Title }}" />
+  {{ end }}
+
   {{ partial "seo_schema" . }}
   {{ partial "js-head" . }}
 </head>
diff --git a/qdrant-landing/themes/qdrant-2024/layouts/partials/table-of-contents.html b/qdrant-landing/themes/qdrant-2024/layouts/partials/table-of-contents.html
index 4c7f1e61d..efd477dbd 100644
--- a/qdrant-landing/themes/qdrant-2024/layouts/partials/table-of-contents.html
+++ b/qdrant-landing/themes/qdrant-2024/layouts/partials/table-of-contents.html
@@ -24,6 +24,12 @@
       {{ else }}
         <ul class="table-of-contents__external-links">
           {{ if or (eq .Section "documentation") (eq .Section "articles") }}
+            <li class="table-of-contents__link">
+              <a href="{{ .Permalink }}index.md" target="_blank">
+                {{ partial "svg" "markdown.svg" }}
+                View as Markdown
+              </a>
+            </li>
             <li class="table-of-contents__link">
               <a href="{{ .Site.Params.githubDocPrefix }}{{ path.Clean .File.Path }}" target="_blank">
                 {{ partial "svg" "github.svg" }}
diff --git a/qdrant-landing/themes/qdrant-2024/static/icons/outline/markdown.svg b/qdrant-landing/themes/qdrant-2024/static/icons/outline/markdown.svg
new file mode 100644
index 000000000..654beaa22
--- /dev/null
+++ b/qdrant-landing/themes/qdrant-2024/static/icons/outline/markdown.svg
@@ -0,0 +1,4 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path fill-rule="evenodd" clip-rule="evenodd" d="M1.5 0C1.22386 0 1 0.223858 1 0.5V15.5C1 15.7761 1.22386 16 1.5 16H14.5C14.7761 16 15 15.7761 15 15.5V5.5C15 5.36739 14.9473 5.24021 14.8536 5.14645L9.85355 0.146447C9.75979 0.0526784 9.63261 0 9.5 0H1.5ZM2 15V1H9.29289L14 5.70711V15H2ZM4 5.5C4 5.22386 4.22386 5 4.5 5H6.5C6.77614 5 7 5.22386 7 5.5C7 5.77614 6.77614 6 6.5 6H4.5C4.22386 6 4 5.77614 4 5.5ZM4.5 8C4.22386 8 4 8.22386 4 8.5C4 8.77614 4.22386 9 4.5 9H11.5C11.7761 9 12 8.77614 12 8.5C12 8.22386 11.7761 8 11.5 8H4.5ZM4.5 11C4.22386 11 4 11.2239 4 11.5C4 11.7761 4.22386 12 4.5 12H11.5C11.7761 12 12 11.7761 12 11.5C12 11.2239 11.7761 11 11.5 11H4.5Z" fill="#DC244C"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M9.5 0C9.77614 0 10 0.223858 10 0.5V5H14.5C14.7761 5 15 5.22386 15 5.5C15 5.77614 14.7761 6 14.5 6H9.5C9.22386 6 9 5.77614 9 5.5V0.5C9 0.223858 9.22386 0 9.5 0Z" fill="#DC244C"/>
+</svg>