Moonkale

Markdown and Typst Editor

2 min read

Crate: editors/markdown. The knowledge half of the project.

Markdown (Obsidian conventions)

  • [[wiki-links]], [[page#heading|heading]], [[page|alias]], ![[embeds]], frontmatter, tags, callouts.
  • WYSIWYG via Milkdown (ProseMirror) behind RichTextBackend (JS Interop Boundary); source mode = the Code Editor with lang: markdown.
  • Milkdown round-trips to Markdown; we store Markdown, so ProseMirror-only state is intentionally lost. That’s what makes the backend replaceable.
  • Rust-side model (pulldown-cmark → block tree) exists regardless of backend: outline, link extraction, embeds and rename-propagation work without JS.

Every link is a Links edge extracted by Indexing. Backlinks = Query::Neighbours{direction: In, kind: Links}. The “local graph” pane is the Graph View at depth 1 — no separate implementation. Links can target any node, including a database row or a symbol: [[users]] may resolve to a Postgres table. Resolution uses Obsidian’s shortest-unique-path rules, extended with source scoping.

Typst

  • typst is pure Rust and compiles to wasm → in-process compile on every platform (ADR-0007 Typst via the native crate).
  • World impl backed by the folder source (files, fonts, packages cache).
  • Editing: code editor + live SVG preview. A structured/WYSIWYG Typst editor is research (Typst’s AST is available via typst-syntax, which makes a block-level editor plausible later).
  • Diagnostics map to editor ranges like LSP diagnostics.

Diagrams

Mermaid blocks render in preview via a small JS package if/when needed (same interop rules); Typst diagrams (CeTZ) come for free with Typst. Excalidraw: open question — embed the web app behind the interop boundary, or treat .excalidraw JSON as a Block graph in the Flow Editor canvas. Leaning to the latter, later.

Phases

  1. Source-mode markdown with link completion + backlinks + local graph.
  2. Milkdown WYSIWYG.
  3. Typst preview.
  4. Embeds of any node (![[users]] renders a table).

Graph View

Backlinks