Guides & Tutorials

Comprehensive documentation on Markdown rendering, supported diagrams, and output formats.

Diagrams

WireViz Diagrams in Markdown

How to document wiring harnesses, cable assemblies, and connector pinouts in Markdown using WireViz YAML — then export the result to a print-ready PDF.

Read guide
Diagrams

WaveDrom Timing Diagrams

How to use WaveDrom to draw digital timing diagrams, logic waveforms, and register maps in Markdown using a simple JSON syntax.

Read guide
Diagrams

Vega-Lite Data Visualizations

A high-level grammar of interactive graphics embedded in Markdown — declarative statistical charts defined entirely in JSON.

Read guide
Diagrams

UMLet Diagrams in Markdown

How to use UMLet's text-based syntax to produce quick UML class, sequence, and state diagrams inside Markdown without opening a drawing tool.

Read guide
Diagrams

TikZ Diagrams in Markdown

How to write TikZ graphics commands in Markdown to produce high-quality LaTeX-grade technical diagrams, plots, and geometric figures.

Read guide
Use Cases

Writing Technical Documentation in Markdown

A practical guide to using Markdown for software documentation — covering structure, code examples, versioning, and publishing best practices.

Read guide
How-To

Adding a Table of Contents to Your Document

Learn how to automatically generate a clickable Table of Contents from your Markdown headings for both HTML and PDF output.

Read guide
Diagrams

SVG Bob: Modern ASCII Art

Convert hand-drawn ASCII art diagrams into razor-sharp scalable SVG graphics in Markdown — ideal for readable diagrams that stay legible in source files.

Read guide
How-To

Sharing Documents Publicly

Learn how to generate a public share link for your Markdown document so anyone can view the rendered HTML version without an account.

Read guide
Use Cases

Writing a Resume in Markdown and Exporting to PDF

A step-by-step guide to creating a professional, ATS-friendly resume in Markdown and exporting it as a polished PDF — with a complete template.

Read guide
Diagrams

PlantUML Diagrams in Markdown

How to write PlantUML inside fenced code blocks to create sequence, use-case, class, and activity diagrams in Markdown, exportable to PDF.

Read guide
Diagrams

Pikchr Diagrams in Markdown

A PIC-like markup language for technical drawing embedded directly in Markdown — compact, deterministic diagrams with no external tooling.

Read guide
How-To

PDF Export Tips for Perfect Output

Expert tips for getting pixel-perfect, print-ready PDF output from your Markdown documents — covering page layout, fonts, images, and page breaks.

Read guide
Diagrams

Nomnoml Diagrams in Markdown

A fast, highly customizable UML diagram generator driven entirely from text in Markdown, with styling directives for colors, shapes, and layout.

Read guide
How-To

Creating Multi-Page PDF Documents

Strategies for structuring long Markdown documents that span multiple pages, with control over page breaks, headers, footers, and section flow.

Read guide
Diagrams

Mermaid Flowcharts & Sequence Diagrams in Markdown

How to render Mermaid diagrams inside Markdown — flowcharts, sequence, Gantt, class, and state diagrams — with live preview and PDF export.

Read guide
Use Cases

Markdown for Meeting Notes and Reports

Templates and best practices for using Markdown to write structured meeting notes, status reports, and recurring documents that are easy to share and archive.

Read guide
Technical

Markdown vs Rich Text — When to Use Each

A practical comparison of Markdown and rich text editors (Word, Google Docs) to help you choose the right tool for your writing workflow.

Read guide
How-To

The Complete Markdown Cheatsheet

A comprehensive reference for every Markdown syntax element — headings, links, tables, code blocks, and more — with live examples.

Read guide
Technical

LaTeX vs KaTeX — Math Notation in the Browser

A deep-dive comparison of LaTeX and KaTeX for rendering mathematical expressions in web documents and PDFs, with syntax examples and performance notes.

Read guide
History & Concepts

KaTeX Math Equations in Markdown

How to write and render LaTeX mathematics inside standard Markdown with KaTeX — inline and block equations, matrices, and aligned environments.

Read guide
Technical

How PDF Generation Works Under the Hood

A technical deep-dive into how Markdown documents are transformed into print-ready PDFs — covering parsing, rendering, layout engines, and the headless browser pipeline.

Read guide
History

History of SVG — Scalable Vector Graphics

The complete history of SVG, from the browser wars of the 1990s through its adoption as the universal format for web graphics, icons, and technical diagrams.

Read guide
History & Concepts

The History of Portable Document Format (PDF)

How John Warnock's 'Camelot Project' revolutionized document sharing visually unchanged across all operating systems.

Read guide
History & Concepts

The Complete History of Markdown

A deep dive into the origins, evolution, and impact of Markdown on digital writing from 2004 to today.

Read guide
History

History of LaTeX

The remarkable story of how Donald Knuth's frustration with typesetting led to TeX, and how Leslie Lamport's LaTeX became the universal standard for scientific publishing.

Read guide
History & Concepts

The History of HTML

A chronological journey from HTML 1.0 to HTML5, and how the web's markup language evolved.

Read guide
History

History of Diagrams — From Flowcharts to Code

A fascinating history of how engineers and scientists moved from hand-drawn schematics to today's text-based diagram tools like Mermaid, Graphviz, and D2.

Read guide
Diagrams

Graphviz / DOT in Markdown

Mastering the DOT language to generate mathematically precise network and graph layouts natively in Markdown, then export them to PDF.

Read guide
How-To

Getting Started with Markdown to PDF

A complete beginner's guide to converting Markdown documents into beautiful, print-ready PDFs using Markdown to Pretty PDF.

Read guide
Technical

Flowcharts in Markdown: Mermaid vs Graphviz vs D2

A detailed comparison of three powerful flowchart tools — Mermaid, Graphviz, and D2 — with equivalent examples to help you choose the right one.

Read guide
Diagrams

Excalidraw Diagrams in Markdown

How to embed hand-drawn style Excalidraw diagrams directly in Markdown documentation and export them to PDF with the sketch aesthetic intact.

Read guide
Diagrams

ERD Diagrams in Markdown

How to create Entity-Relationship Diagrams (ERD) from plain text in Markdown — model tables, keys, and cardinality, and export them to PDF.

Read guide
How-To

Embedding Images in Markdown

A complete guide to embedding local images, remote URLs, SVGs, and HTML-controlled images in Markdown documents for PDF and HTML export.

Read guide
Diagrams

ASCII Art to Images with Ditaa

How to turn classic plain-text ASCII diagrams into beautiful bitmap images using Ditaa.

Read guide
Diagrams

D2 Architecture Diagrams Guide

A modern, highly productive declarative language for generating beautiful architecture diagrams directly from text.

Read guide
Technical

Choosing the Right Diagram Tool

A practical guide to selecting the best diagram tool for your use case — comparing Mermaid, PlantUML, Graphviz, D2, Vega-Lite, and more.

Read guide
Diagrams

Chart.js Data Visualizations in Markdown

How to embed bar charts, line graphs, and pie charts in Markdown using Chart.js JSON configurations, rendered live and exported to PDF.

Read guide
Diagrams

C4 Model Diagrams in Markdown

How to create C4 architecture diagrams — context, container, component, and code — in Markdown using C4-PlantUML and Structurizr syntax.

Read guide
Diagrams

Bytefield Diagrams in Markdown

How to draft bytefield diagrams for bit-level protocol and packet documentation in Markdown, with precise field widths and offsets rendered as SVG.

Read guide
Diagrams

BPMN Diagrams in Markdown

How to embed Business Process Model and Notation (BPMN) diagrams in Markdown to document business workflows, approvals, and swimlanes as text.

Read guide
Diagrams

BlockDiag Diagrams in Markdown

A Python-inspired syntax for generating clean block, sequence, activity, and packet diagrams in Markdown, rendered automatically to SVG.

Read guide
Use Cases

Architecture Diagrams for Engineers with C4 and Mermaid

A practical guide to creating clear software architecture diagrams using the C4 model and Mermaid, with worked examples for every level of abstraction.

Read guide
Use Cases

Creating API Documentation in Markdown

How to write clear, complete, and maintainable API documentation using Markdown — covering endpoints, request/response schemas, code examples, and authentication.

Read guide
Use Cases

Writing Academic Papers with Math Using KaTeX

How to write academic papers, theses, and technical reports in Markdown with fully typeset mathematical notation using KaTeX — complete with structure, citations, and PDF export.

Read guide