Skip to main content
Mintlify pages are written in MDX, which is Markdown with support for JSX components. Everything you already know about Markdown works here — headings, bold, links, blockquotes, and more — and you can mix in Mintlify components wherever plain Markdown isn’t enough.

​
Titles and subtitles

Use ## for section headings and ### for subsections. Each heading automatically generates an anchor link and appears in the right-hand table of contents. 
## This is a section heading

### This is a subsection heading
Avoid using # (h1) inside page content — the page title in frontmatter already renders as the h1.

​
Text formatting

Wrap text with the following syntax to apply inline formatting:
StyleSyntaxOutput
Bold**bold text**bold text
Italic_italic text_italic text
Strikethrough~strikethrough text~strikethrough text
Superscript<sup>superscript</sup>textsup
Subscript<sub>subscript</sub>textsub
You can combine these — for example, **_bold and italic_** produces bold and italic text. Use standard Markdown link syntax for both internal and external links. 
[External link](https://example.com)
[Internal link](/essentials/navigation)
For internal links, always use root-relative paths starting with /. Do not include the .mdx file extension. 
<!-- Correct -->
[Navigation guide](/essentials/navigation)

<!-- Avoid — relative paths work but are slower to optimize -->
[Navigation guide](../essentials/navigation)

​
Blockquotes

Prefix a line with > to render it as a blockquote: 
> Dorothy followed her through many of the beautiful rooms in her castle.
Dorothy followed her through many of the beautiful rooms in her castle.

​
LaTeX

Wrap LaTeX expressions in a <Latex> tag to render mathematical equations: 
<Latex>8 x (vk x H1 - H2) = (0,1)</Latex>
8 x (vk x H1 - H2) = (0,1)

​
HTML in Markdown

Mintlify supports HTML tags inside Markdown, which gives you extra formatting flexibility when standard Markdown syntax isn’t enough. For example, you can use <sup> and <sub> for superscript and subscript, or <br /> for explicit line breaks.