Authoring

Markdown & components

Beyond standard markdown, Filemark renders a rich set of interactive components — so a plain .md file can hold charts, boards, diagrams, and planning docs.

GitHub-Flavored Markdown

Everything you expect: headings, bold/italic, links, images, tables, ordered/unordered lists, blockquotes, strikethrough, footnotes, and task list checkboxes that toggle and persist. Code blocks are syntax-highlighted with Shiki across 30+ languages, theme-matched to your current theme. Emoji shortcodes like :rocket: render too.

Diagrams & math

Fenced ```mermaid blocks render as pan/zoom diagrams (flowchart, sequence, class, state, ER, gantt, mindmap, and more). ```mindmap renders an interactive markmap. Math uses KaTeX — block math with $$…$$ (and a ```math fence).

Currency vs. math

A lone $ is treated as plain text (so “$150k” renders normally) — use $$…$$ for inline/block math.

The component library

These render from fenced code blocks (e.g. ```chart, ```kanban) or HTML-style tags (e.g. <Callout>) — no build step, and nothing is evaluated as JavaScript (Manifest V3 forbids it). A non-exhaustive map:

Structure & callouts
  • Callout (note / tip / info / warning / danger)
  • Tabs + Tab
  • Details (collapsible)
  • Steps + Step
  • Cards + DocCard
Data & charts
  • Datagrid (from CSV/TSV fences or src=)
  • Chart (bar / line / pie / area / scatter / funnel / radar)
  • Kanban board
  • Stats / KPI tiles
  • Heatmap, Sparkline, Gauge, Treemap
Diagrams & math
  • Mermaid (flowchart, sequence, ER, gantt, …)
  • Mindmap (markmap)
  • KaTeX math — $inline$ and $$block$$
  • Schema / ER diagrams (sql / prisma / dbml)
  • FileTree
Planning & decisions
  • DocBlock (rfc / prfaq / pitch / postmortem / meeting / daily)
  • ADR (architecture decision record)
  • Roadmap, Timeline, OKRtree
  • WeightedScore, Matrix2x2, DecisionTree, FiveWhys
  • DocStatus, ReadingTime, Backlinks

Tasks in markdown

Task bullets with sigils (priority, owner, due date, project) power filterable lists, stats, and timelines — and feed the cross-file task panel. See Tasks.

How to write them

The exact grammar for every component — the attributes, the fence syntax, and the two HTML-in-markdown rules — is taught by the Filemark AI skill, so your AI assistant authors them correctly. You can also explore live examples in the playground.