TROFF vs Markdown: Classical Typesetting Markup vs GitHub Flavored Markdown
A technical comparison between classical AT&T troff typography documents and GitHub Flavored Markdown (GFM). Discover formatting requests, macro facilities, and modern documentation pipelines.
Troff is the historic typesetting language created in 1973 by Joe Ossanna and Brian Kernighan at AT&T Bell Laboratories to typeset technical documents and books on phototypesetters and laser printers. GitHub Flavored Markdown (GFM) is the universal lightweight plain-text markup standard designed for web readability, code repositories, issue tracking, and online documentation.
| FEATURE | TROFF | MARKDOWN |
|---|---|---|
| Original Creator | Joe Ossanna / Brian Kernighan (1973) | John Gruber / Aaron Swartz (2004) |
| Target Output | Phototypesetters, PostScript, PDF | HTML, Web Browsers, Documentation |
| Syntax Paradigm | Imperative typesetting dot requests (.sp, .br) | Declarative plain text conventions (#, *, >) |
| Web Ecosystem Compatibility | Requires dedicated compilation pipeline | Native universal web support |
| Learning Curve | Steep (Low-level typography commands) | Minimal (Learned in 5 minutes) |
- Unmatched mathematical precision and micro-typography control over line breaks and kerning
- Extensible macro language enabling custom abbreviations, number registers, and traps
- Rich preprocessor ecosystem (eqn for mathematics, tbl for tables, pic for diagrams)
- Historic format used to typeset seminal computing books including K&R C
- Instantly readable and writable in any plain text editor without compilation
- Universal native rendering on GitHub, GitLab, modern wikis, and content management systems
- Clean intuitive syntax for headings, emphasis, bullet lists, and fenced code blocks
- Seamless integration into modern static site generators (Next.js, Astro, Hugo)
Troff pioneered digital typography, but Markdown dominates modern developer documentation. convrtr parses classic AT&T troff documents into clean GitHub Flavored Markdown with preserved headings, blockquotes, and code blocks 100% offline.
Converting files between TROFF and MARKDOWN frequently? The convrtr Chrome Extension lets you right-click any image on any webpage or open the Side Panel to convert assets instantly using local WebAssembly with zero server uploads.