Supported Markdown
What markdown6 displays and exports correctly — tables, code, math, 12 kinds of charts, images and a little HTML — and what isn’t supported yet.
On this page
Headings and paragraphsEmphasis, lists and tasksTablesCode and highlightingMathMermaid chartsImagesLinks and jumping to sectionsHTML you can useText colorNot supported yetWhen something is wrongIn each example below, the left side is what you type and the right side is how markdown6 shows it. Exported PDF, Word and single-file HTML match the preview. Copy any example into markdown6 to try it.
#Headings and paragraphs
Use # to ###### for heading levels 1 to 6. Unlike many editors, a single line break is a line break — no need for two trailing spaces. Leave a blank line between paragraphs.
### A level 3 heading First line The second line shows right below it. A blank line starts a new paragraph.
A level 3 heading
First line
The second line shows right below it.
A blank line starts a new paragraph.
#Emphasis, lists and tasks
**Bold**, *italic*, ~~strikethrough~~, `inline code` - Bulleted list - Indent two spaces for a sub-item 1. Numbered list 2. Second item - [x] A finished task - [ ] An open task
Bold, italic, strikethrough, inline code
- Bulleted list
- Indent two spaces for a sub-item
- Numbered list
- Second item
- A finished task
- An open task
The toolbar’s Insert menu adds bold (⌘B), italic (⌘I), strikethrough, lists, quotes, links, code blocks and tables.
#Tables
| Phase | Key work | Duration | | --- | :---: | ---: | | Discovery | Interviews | 2 weeks | | Design | Review | 3 weeks |
| Phase | Key work | Duration |
|---|---|---|
| Discovery | Interviews | 2 weeks |
| Design | Review | 3 weeks |
Colons in the second row set alignment: :---: centers, ---: aligns right. Wide tables scroll sideways.
#Code and highlighting
Wrap code in three backticks and name the language:
```python
def roi(gain: float, cost: float) -> float:
return (gain - cost) / cost * 100
```def roi(gain: float, cost: float) -> float:
return (gain - cost) / cost * 100
Highlighted languages: HTML, CSS, JavaScript, TypeScript, JSON, YAML, SQL, Bash, Java, Python, Go and C-like languages; others show as plain text. Code blocks in the preview have a Copy button in the top-right corner.
#Math
Use $…$ for inline math, and a line of $$ before and after for a display equation (or a code block with the language math). The syntax is LaTeX:
The mass–energy equation $E = mc^2$ sits in a sentence.
$$
ROI = \frac{\text{Annual gain} - \text{Cost}}{\text{Cost}} \times 100\%
$$The mass–energy equation sits in a sentence.
If you don’t know LaTeX, use Equation › Equation editor… in the toolbar: pick symbols by category (common symbols, Greek letters, fractions and derivatives, roots and scripts, integrals, matrices and more), watch the live preview, and click Insert.
#Mermaid charts
Write charts in a code block with the language mermaid; their colors follow the current theme. The toolbar’s Chart menu has 12 templates: flowchart, sequence, Gantt, class, state, pie, journey, Git graph, mind map, timeline, XY chart and quadrant chart.
```mermaid
flowchart LR
A[Interviews] --> B[Design review]
B --> C{Approved?}
C -->|Yes| D[Phased rollout]
C -->|No| A
``````mermaid sequenceDiagram Client->>Consultant: Shares requirements Consultant->>Team: Splits the work Team-->>Consultant: Delivers a draft Consultant-->>Client: Sends the PDF ```
```mermaid pie title Budget "People" : 55 "Software" : 25 "Travel" : 20 ```
Images

{width=50%}
- Image paths are relative to the document’s folder; wrap paths that contain spaces in
<…>. - A trailing
{width=100%},{width=50%}or{width=original}means fit width, half width or original size. You can also click the image in the preview and use the size bar. - Paste screenshots and drag image files straight into the editor; markdown6 saves them in the
<document name>.assetsfolder next to the document and writes the reference for you.
#Links and jumping to sections
[The markdown6 website](https://markdown6.com) Jump to the [Tables](#tables) section of this page.
Jump to the Tables section of this page.
Every heading gets an anchor automatically, so #heading-text links within the document; the toolbar’s Outline also jumps by heading. External links in the preview open in your browser.
#HTML you can use
For safety, only a few common HTML tags are kept — for example collapsible sections, sub- and superscript, keys and highlights. Scripts, styles and embedded pages are removed.
Press <kbd>⌘</kbd> + <kbd>S</kbd> to save, <mark>highlight</mark> what matters, H<sub>2</sub>O and x<sup>2</sup>. <details> <summary>Click to expand</summary> The collapsed content. </details>
Press ⌘ + S to save, highlight what matters, H2O and x2.
Click to expand
The collapsed content.
#Text color
Markdown has no text color. Use <font color> or <span style="color / background-color"> to mark figures red or green, or add a background (from 0.2.3). Colors can be names (red, green, orange …), #f00, #ff0000 or rgb(255, 0, 0).
| Metric | Attainment | |---|---| | Signed | <font color="red">78%</font> | | Collected | <font color="green">108%</font> | Risk: <span style="background-color: yellow">contract not filed</span>
| Metric | Attainment |
|---|---|
| Signed | 78% |
| Collected | 108% |
Risk: contract not filed
You don't have to type the tags: select some text, then click Color on the toolbar or right-click and pick a color (from 0.2.8). The palette starts with Theme color (your current theme’s main color), followed by 6 text colors (red, orange, green, blue, purple, gray) and 4 highlights (yellow, green, blue, pink); for any other color, click ⊕ More… to open the system color picker, and colors you have used stay under “Recent”. Picking a color on text that already has one changes it, and Clear color removes the tags but keeps the text. ⌘⇧C (Ctrl+Shift+C on Windows) applies the last color you used, handy for marking several figures in a row. Code blocks and inline code can't be colored.
- Only text color and background are supported; font size, font family and other styles are removed and the text shows as usual.
- Palette colors match your theme: the same
redis a warm red in Clay and a soft bright red on dark themes, and changes with the theme; other editors still show standard red. For a color that must never change (such as a company warning color), pick it with More…. - If a color is hard to read on the current theme, it is darkened or lightened slightly (same hue) — for example
#008000becomes a little brighter on dark themes. - Exported PDF and single-file HTML show the colors too. In Word, “Theme accent color” gives real Word font colors you can keep editing; “Black and white” doesn’t use colors.
#Not supported yet
- Footnotes (
[^1]) and callouts (> [!NOTE]) show as plain text or a quote. - A
---front matter block at the top of the document shows as regular content. <script>,<iframe>,styleother than text color and similar are removed, andjavascript:links don’t work.
#When something is wrong
If an equation or chart has an error, the preview shows “Equation error (line N)” or “Chart error (line N)” with the reason at that spot. Click Go to source to jump to the line. Everything else still renders, and your source isn’t changed.
if there are equation or chart errors or missing images, export asks you to fix them first.
Still stuck? Email support@miniidealab.com.