# Markdown in Unmarked

What Markdown Unmarked renders

Last updated

Unmarked renders CommonMark plus the GitHub extensions most files use (tables, task lists, strikethrough), YAML frontmatter, LaTeX math, colored code blocks and Mermaid diagrams. The parser is Apple's swift-markdown.

The full list of what renders

  • Headings, levels 1 through 6
  • Paragraphs and line breaks
  • Bold, italic, and strikethrough
  • Ordered, unordered, and nested lists
  • Task lists, with checkboxes you can tick in Read mode
  • Blockquotes
  • Inline code
  • Fenced code blocks, colored by their language tag
  • Math, inline with $…$ and on its own lines with $$…$$ or a math block
  • Mermaid diagrams, from a fenced mermaid code block
  • Links (clickable in Read mode)
  • Local images
  • Tables
  • Horizontal rules
  • YAML frontmatter, shown as a properties panel

Colored code blocks

Name the language after the opening fence and Unmarked colors the block:

```python
def greet(name):
    return f"Hello, {name}"
```

The tag decides. Unmarked doesn't guess, so a block with no tag, or a tag it doesn't know, stays plain. About 60 languages are covered, from Python, JavaScript, Swift and Rust to shell, SQL, YAML and Dockerfile. Inline code is never colored.

On screen, the colors come from your theme, in light and dark, and Read and Write color a block the same way. PDF, Print, Word and Copy as Rich Text use one fixed set of light code colors that suits paper. The self-contained HTML export is colored too. The minimal HTML export keeps the structure without colors, ready for your own stylesheet.

What isn't rendered yet

Footnotes ([^1]) show as the plain text you typed, and https:// images show their alt text. What's not rendered yet explains both.