Add remark-slug (#862)

* Add remark-slug

* Add remark-slug in documentation

* Add changeset

2 files changed, 3 insertions, 0 deletions

diff --git a/packages/markdown-support/package.json b/packages/markdown-support/package.json
index d5f10add1..3d9917a79 100644
--- a/packages/markdown-support/package.json
+++ b/packages/markdown-support/package.json
@@ -25,6 +25,7 @@
     "remark-gfm": "^1.0.0",
     "remark-parse": "^9.0.0",
     "remark-rehype": "^8.1.0",
+    "remark-slug": "^6.1.0",
     "unified": "^9.2.1",
     "unist-util-map": "^3.0.0"
   },
diff --git a/packages/markdown-support/src/index.ts b/packages/markdown-support/src/index.ts
index 168738ea2..5278d44d6 100644
--- a/packages/markdown-support/src/index.ts
+++ b/packages/markdown-support/src/index.ts
@@ -12,6 +12,7 @@ import unified from 'unified';
 import markdown from 'remark-parse';
 import markdownToHtml from 'remark-rehype';
 import rehypeStringify from 'rehype-stringify';
+import remarkSlug from 'remark-slug';
 
 export { AstroMarkdownOptions, MarkdownRenderingOptions };
 
@@ -30,6 +31,7 @@ export async function renderMarkdown(content: string, opts?: MarkdownRenderingOp
   const { headers, rehypeCollectHeaders } = createCollectHeaders();
   let parser = unified()
     .use(markdown)
+    .use(remarkSlug)
     .use([remarkExpressions, { addResult: true }]);
 
   if (remarkPlugins.length === 0) {