docsreferenceMarkdown support

#Markdown support

MDReader renders GitHub-Flavored Markdown through a single unified pipeline. This page is itself rendered by that pipeline — every feature below is live.

#Headings and outline

Headings h1–h6 become outline entries with stable anchor ids.

#Text

Bold, italic, strikethrough, inline code, and autolinks like https://example.com all render. Footnotes work too.1

#Tables

FeatureRendersNotes
TablesGFM alignment respected
Task listsRendered as task items
FootnotesIds namespaced to avoid clashes

#Task lists

  • Parse frontmatter
  • Stamp source line ranges onto every block
  • Edit the file (that is the desktop app's job)

#Code

python
def read_time(words: int, wpm: int = 220) -> float:
    """Estimate minutes to read a document."""
    return words / wpm

#Math

Inline math renders with KaTeX: the golden ratio is φ=1+52\varphi = \frac{1 + \sqrt{5}}{2}. Display math too:

0ex2dx=π2\int_{0}^{\infty} e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}

#Diagrams

Fenced mermaid blocks render as diagrams:

flowchart LR
  Source[Markdown file] --> Parse[Unified pipeline]
  Parse --> Read[Reading surface]
  Parse --> Index[CatDB index]
  Index --> Search[Cmd+K palette]

Type [[notes/provenance]] to link across the workspace. Resolvable targets are marked; dangling ones stay visibly unresolved.

#Footnotes

  1. And land back where you left off.