Concepts

The deep dives, for when you want to understand or change how Markbridge works:

• Architecture — the parse → AST → render pipeline, and why it’s shaped that way.
• The AST — node types, invariants, and how the tree is built and walked.
• Result objects — what you get back: the Conversion and Parse value objects.
• Parsers — how each of the four parsers works, and their trade-offs.
• Renderers — the Discourse renderer, Tags, and the rendering interface.
• AST normalization — the pass that rewrites nesting Markdown can’t express before rendering.
• Performance — where the pipeline is tuned, and how to measure your own workload.