From cc2e615b9a790c58a8dcf5f9f27cc7c213df28d2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Samy=20Pess=C3=A9?= <samypesse@gmail.com>
Date: Wed, 6 Aug 2025 08:55:02 +0200
Subject: [PATCH] Emit a <link rel="alternate"> for the markdown version of a
 page (#3528)

---
 .changeset/rude-tomatoes-hunt.md                      | 5 +++++
 packages/gitbook/src/components/SitePage/SitePage.tsx | 3 +++
 2 files changed, 8 insertions(+)
 create mode 100644 .changeset/rude-tomatoes-hunt.md

diff --git a/.changeset/rude-tomatoes-hunt.md b/.changeset/rude-tomatoes-hunt.md
new file mode 100644
index 000000000..eee72ce7d
--- /dev/null
+++ b/.changeset/rude-tomatoes-hunt.md
@@ -0,0 +1,5 @@
+---
+"gitbook": minor
+---
+
+Emit a <link rel="alternate"> for the markdown version of a page
diff --git a/packages/gitbook/src/components/SitePage/SitePage.tsx b/packages/gitbook/src/components/SitePage/SitePage.tsx
index bdd1cbc78..72bdc292e 100644
--- a/packages/gitbook/src/components/SitePage/SitePage.tsx
+++ b/packages/gitbook/src/components/SitePage/SitePage.tsx
@@ -135,6 +135,9 @@ export async function generateSitePageMetadata(props: SitePageProps): Promise<Me
             canonical: linker
                 .toAbsoluteURL(linker.toPathForPage({ pages: revision.pages, page }))
                 .replace(/\/+$/, ''),
+            types: {
+                'text/markdown': `${linker.toAbsoluteURL(linker.toPathInSpace(page.path))}.md`,
+            },
         },
         openGraph: {
             images: [