Skip to content

Explanation

Explanation pages describe why md-to-pdf works the way it does.

Read these when you want the design background behind browser rendering, Mermaid handling, safety defaults, and dependency choices.

Topics

  • Rendering pipeline

    Why conversion goes through HTML and a Chromium-family browser.

  • Mermaid rendering

    Why Mermaid is rendered at browser time and how readiness is detected.

  • Safety model

    What the defaults reduce, and what remains outside scope.

  • Design tradeoffs

    Why this first version depends on a browser instead of pure Rust PDF rendering.