Guides & Tutorials

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

Diagrams

WireViz Diagrams in Markdown

How to document wiring harnesses and pinout diagrams.

Read guide
Diagrams

WaveDrom Timing Diagrams

How to use WaveDrom to draw digital timing diagrams, waveforms, and CPU architectures in Markdown.

Read guide
Diagrams

Vega-Lite Data Visualizations

A high-level grammar of interactive graphics, embedded securely in your Markdown files.

Read guide
Diagrams

UMLet Diagrams in Markdown

How to use UMLet text-based syntax to output quick UML diagrams.

Read guide
Diagrams

TikZ Diagrams in Markdown

How to write TikZ graphics commands to create high-quality LaTeX diagrams.

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 textual ASCII diagrams into razor-sharp, scalable SVG graphics.

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 syntax inside fenced code blocks to create sequence, use-case, and class diagrams.

Read guide
Diagrams

Pikchr Diagrams in Markdown

A PIC-like markup language for technical drawing embedded directly in Markdown.

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 sassy, fast, and highly customizable UML diagram generator directly from text.

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

An excruciatingly detailed guide on how to render Mermaid diagrams directly inside your Markdown documents.

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 beautifully render LaTeX mathematics equations cleanly inside standard Markdown.

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 perfect network and graph layouts natively in Markdown.

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 beautiful, hand-drawn style Excalidraw diagrams directly in your documentation.

Read guide
Diagrams

ERD Diagrams in Markdown

How to create Entity-Relationship Diagrams (ERD) using plain text.

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 dynamically using Chart.js JSON configurations.

Read guide
Diagrams

C4 Model Diagrams in Markdown

How to create C4 architecture diagrams using C4-PlantUML and Structurizr.

Read guide
Diagrams

Bytefield Diagrams in Markdown

How to draft bytefields and bit-level protocol documentation.

Read guide
Diagrams

BPMN Diagrams in Markdown

How to embed Business Process Model and Notation diagrams.

Read guide
Diagrams

BlockDiag Diagrams in Markdown

A Python-inspired syntax for generating clean block and packet diagrams.

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