mathdown

What problem does it solve?

It converts scattered mathematical materials into consistent Obsidian markdown, preserving block identity for reliable cross-file references.

Core Features & Use Cases

• Multi-source math ingestion: Take LaTeX, web pages, PDFs, images/OCR, and existing markdown/text and normalize them into a unified Obsidian math-note format.
• Stable block mapping for citations: Maintain and update a cross-reference block map (label → block_id) so \ref-style citations can be converted into [[file#^block_id]] reliably.
• Math formatting discipline: Enforce strict rules for inline/display math, callout-based theorem/definition structure, TikZ-only diagram rendering, and conservative rewriting that avoids inventing unsupported claims.
• Automated workflow support: Use provided scripts to preprocess LaTeX chapters (macro expansion, index cleanup), build the label map from converted markdown, and validate common conversion issues.

Quick Start

Ask the assistant to convert a LaTeX chapter file into Obsidian markdown following mathdown’s formatting rules and then update the unified label map so all cross-references resolve to stable block IDs.