markdown6 Download
User Guide › Writing and editing

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.

For markdown6 0.2.0 and later · Updated 2026-11-07

On this pageHeadings and paragraphsEmphasis, lists and tasksTablesCode and highlightingMathMermaid chartsImagesLinks and jumping to sectionsHTML you can useText colorNot supported yetWhen something is wrong

In 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.

Markdown
### A level 3 heading

First line
The second line shows right below it.

A blank line starts a new paragraph.
Result

A level 3 heading

First line
The second line shows right below it.

A blank line starts a new paragraph.

#Emphasis, lists and tasks

Markdown
**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
Result

Bold, italic, strikethrough, inline code

  • Bulleted list
    • Indent two spaces for a sub-item
  1. Numbered list
  2. 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

Markdown
| Phase | Key work | Duration |
| --- | :---: | ---: |
| Discovery | Interviews | 2 weeks |
| Design | Review | 3 weeks |
Result
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:

Markdown
```python
def roi(gain: float, cost: float) -> float:
    return (gain - cost) / cost * 100
```
Result
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:

Markdown
The mass–energy equation $E = mc^2$ sits in a sentence.

$$
ROI = \frac{\text{Annual gain} - \text{Cost}}{\text{Cost}} \times 100\%
$$
Result

The mass–energy equation E=mc2E = mc^2 sits in a sentence.

ROI=Annual gain−CostCost×100%ROI = \frac{\text{Annual gain} - \text{Cost}}{\text{Cost}} \times 100\%

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.

Markdown
```mermaid
flowchart LR
  A[Interviews] --> B[Design review]
  B --> C{Approved?}
  C -->|Yes| D[Phased rollout]
  C -->|No| A
```
Result
YesNoInterviewsDesign reviewApproved?Phased rollout
Markdown
```mermaid
sequenceDiagram
  Client->>Consultant: Shares requirements
  Consultant->>Team: Splits the work
  Team-->>Consultant: Delivers a draft
  Consultant-->>Client: Sends the PDF
```
Result
TeamConsultantClientTeamConsultantClientShares requirementsSplits the workDelivers a draftSends the PDF
Markdown
```mermaid
pie title Budget
  "People" : 55
  "Software" : 25
  "Travel" : 20
```
Result
55%25%20%BudgetPeopleSoftwareTravel

Images

![Process overview](process.png)
![A half-width screenshot](<Screenshot 1.png>){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>.assets folder next to the document and writes the reference for you.
Markdown
[The markdown6 website](https://markdown6.com)

Jump to the [Tables](#tables) section of this page.
Result

The markdown6 website

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.

Markdown
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>
Result

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).

Markdown
| Metric | Attainment |
|---|---|
| Signed | <font color="red">78%</font> |
| Collected | <font color="green">108%</font> |

Risk: <span style="background-color: yellow">contract not filed</span>
Result
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 red is 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 #008000 becomes 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>, style other than text color and similar are removed, and javascript: 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.

Note

if there are equation or chart errors or missing images, export asks you to fix them first.

Still stuck? Email support@miniidealab.com.