11---
2+ title : Markdown Features
23id : introduction
34description : Learn how Docusaurus extends Markdown with MDX, front matter, components, and interactive elements.
45slug : /markdown-features
56---
67
7- # Markdown Features
8-
98Docusaurus uses ** [ Markdown] ( https://commonmark.org/ ) ** as the primary format for writing documentation,
109but it extends it with ** [ MDX] ( https://mdxjs.com/ ) ** , enabling React components inside Markdown files.
1110
@@ -36,8 +35,6 @@ This renders both the Markdown heading and the `<MyComponent />` React component
3635Use the [ MDX Playground] ( https://mdxjs.com/playground/ ) to see how your Markdown+JSX compiles to React.
3736:::
3837
39- <AdsComponent />
40-
4138## MDX vs CommonMark { #mdx - vs - commonmark }
4239
4340Docusaurus supports two Markdown parsing modes:
@@ -60,8 +57,6 @@ export default {
6057CommonMark support is still experimental and may differ from other renderers.
6158:::
6259
63- <AdsComponent />
64-
6560## Standard Markdown Features { #standard - features }
6661
6762All familiar Markdown syntax works:
@@ -79,8 +74,6 @@ Some **bold** text, some _italic_, and a [link](/).
7974</BrowserWindow>
8075```
8176
82- <AdsComponent />
83-
8477## Front Matter { #front - matter }
8578
8679Front matter lets you add ** metadata** to your Markdown files.
@@ -148,8 +141,6 @@ Docusaurus supports `<details>` for collapsible content:
148141</BrowserWindow>
149142```
150143
151- <AdsComponent />
152-
153144## Assets & Images { #assets }
154145
155146Use relative paths to reference images and files:
@@ -169,4 +160,4 @@ Docusaurus will automatically optimize and resolve the asset URLs.
169160---
170161
171162With ** Markdown + MDX** , you can start with simple text and gradually enhance pages with
172- dynamic React components, interactive demos, and custom UI elements—all in one file.
163+ dynamic React components, interactive demos, and custom UI elements—all in one file.
0 commit comments