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