From ec35fdd768519e2d6f4a7de17d7a9b7bfaaa3c94 Mon Sep 17 00:00:00 2001
From: Ian VanSchooten <ian.vanschooten@gmail.com>
Date: Wed, 1 Dec 2021 08:36:28 -0800
Subject: [PATCH] Add migration guide for markdownOptions (#2070)

---
 docs/src/pages/migration/0.21.0.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/docs/src/pages/migration/0.21.0.md b/docs/src/pages/migration/0.21.0.md
index 38a7236e92..3adc7e6b61 100644
--- a/docs/src/pages/migration/0.21.0.md
+++ b/docs/src/pages/migration/0.21.0.md
@@ -193,6 +193,29 @@ To learn more about Vite plugins, please visit their [plugin guide](https://vite
 
 > In prior releases, these were configured with `snowpackPlugin` or `snowpackPluginOptions`.
 
+## Markdown Options
+
+The configuration of markdown options has changed slightly in Astro v0.21. There's now a `render` property, which should include `@astrojs/markdown-remark`:
+
+```diff
+// astro.config.mjs
+export default {
+  markdownOptions: {
++    render: [
++      '@astrojs/markdown-remark',
++      {
+        remarkPlugins: [
+          // Add a Remark plugin that you want to enable for your project.
+        ],
+        rehypePlugins: [
+          // Add a Rehype plugin that you want to enable for your project.
+        ],
++      },
++    ],
+  },
+};
+```
+
 ## Styling Changes
 
 ### Autoprefixer