Updated for Markion v0.3.1 · 2026-09-04

DOCUMENTATION

Markdown & rendering

Markion parses Markdown with pulldown-cmark , targeting CommonMark and GFM. Markdown remains the canonical document format at all times.

Formatting commands

Formatting commands cover bold, italic, inline code, links, images, headings, lists, task lists, blockquotes, fenced code blocks, and source Markdown tables. Heading commands expose H1–H5 by default, with an H1–H6 option in Preferences.

Find and replace

Supports case sensitivity, regular expressions, next/previous navigation, replace current, and replace all.

Tables

  • Source table commands can format tables and add, delete, or move rows and columns.
  • Visual Edit tables additionally provide direct source-backed cell editing, Tab traversal, content-aware column widths, and the same row/column operations.
  • Ordinary preview tables remain read-only.

Local image workflow

A local image-resource workflow ingests clipboard images and dragged image files:

  • Markion copies or encodes them into a document-relative asset directory with collision-resistant names and inserts portable relative Markdown links.
  • Replacing an existing image keeps its alt text and presentation metadata.
  • Practical size/alignment controls are exposed, and a missing resource shows an explicit missing-resource state.

YAML front matter

--- -delimited YAML front matter is parsed and hidden from preview; its title, author and date feed export metadata (HTML <meta> tags, DOCX document properties, and the LaTeX preamble).

Rendering support

The rendered preview supports:

  • Bold, italic, strikethrough, inline code, links, highlights (==highlight==), superscript (^superscript^), subscript (~subscript~), footnotes, task lists, common emoji shortcodes (such as :smile: and :heart:), and automatic links.
  • Correct ordered-list start numbers, nested lists, per-depth bullets, hanging indentation, images, and embedded HTML.
  • Smart punctuation (smart quotes, dashes) and heading attributes.

Copying from the preview

Preview text is selectable, with a context menu for copying as plain text, Markdown, or HTML—plus link-address copying where applicable.

Math

$...$ inline math and $$...$$ block math are typeset offline into cached SVG with bundled fonts by an embedded RaTeX (KaTeX-compatible) engine—no network access or external LaTeX install required. In practice:

  • Inline formulas keep prose flowing on the same line, and Unicode text works inside formulas (e.g. $\text{速度 } v$).
  • Math coexists with nested Markdown such as bold, links, and inline code, each keeping its own styling.
  • ```math fenced blocks (such as matrix environments) are supported.
  • Deliberately wide formulas scroll horizontally instead of being clipped.
  • Invalid formula source stays visible and editable instead of silently disappearing.
  • In Visual Edit, only the focused formula reveals its complete $...$, $$...$$ or fenced source.

LaTeX export keeps the native $...$/$$...$$ source for the reader's own toolchain to typeset; the built-in DOCX export degrades formulas to a readable plain-text approximation rather than embedding typeset glyphs.

Mermaid diagrams

```mermaid fenced diagrams (flowcharts, sequence diagrams, and more) render to sanitized, cached SVG.

Code highlighting

Fenced code is highlighted with syntect and the two-face extended grammar set, with a fallback lexer for uncovered languages and optional line numbers (toggleable in Preferences or config.toml ).