The Role of h1
The top-level heading introduces the main topic. It should appear only once and set the overall context for everything that follows.
Text styles
You can bold, emphasis, and inline code all in the same sentence.
Or link a component inside text:example. (external)
Or link a component inside text:Our Solutions. (internal)
Here is a manual line break for spacing:
A new line appears here without starting a new paragraph.
Blockquotes
Remember: MDX gives you Markdown simplicity and React power. You can include components inside blockquotes if needed.
Horizontal Rules
You can separate sections using horizontal rules:
Code Blocks
javascript
import Readme from './readme.md' // Assumes an integration is used to compile MDX -> JS.
import {FancyLink} from './components/fancy-link.js'
<Readme components={{a: FancyLink}} />Ordered and Unordered Lists
Unordered
- First item
- Second item
Ordered
- First item
- Second item
Nested
- First item
- First item
- Second item
- Third item
- Second item
- Third item