Man Page to Markdown - Unix Docs Made Readable

Convert Unix man pages to Markdown format. Transform troff/groff documentation into clean, readable Markdown for wikis and documentation sites.

Note: First conversion initializes Pandoc WebAssembly (~55MB download). Subsequent conversions are instant and work offline.

Drop man page file here or click to browse

Accepts .1, .2, .3, etc. or .man files

Man Page Source (troff/groff)

Markdown Output

Enter man page source to convert

Common Man Page Macros

Macro	Purpose	Markdown
`.TH`	Title header	`# Title`
`.SH`	Section header	`## Section`
`.SS`	Subsection	`### Subsection`
`.B`	Bold text	`bold`
`.I`	Italic text	`italic`
`.TP`	Tagged paragraph	Definition list
`.PP`	Paragraph break	Blank line
`.BR`	Bold/Roman alternating	Mixed formatting

Conversion complete

LaTeX to Markdown - Academic Papers to W…

Textile to Markdown - Migrate Redmine Co…

HTML to LaTeX - Convert Web Articles to …

DocBook to Markdown - XML Docs to GitHub…

HTML to AsciiDoc - Web Content to Techni…

View all Markup converters →

Frequently Asked Questions

Man pages are Unix/Linux documentation written in troff/groff format. Converting to Markdown makes them readable on the web, in documentation wikis, or integrated into modern documentation systems without requiring special viewers.

Section headers (.SH), text formatting (.B bold, .I italic), lists, code examples, synopsis sections, option descriptions, and cross-references. Most standard man page constructs translate cleanly to Markdown.

Use 'man -w command' to find the file location, then 'zcat' or 'cat' to extract it. Alternatively, copy from online man page repositories or your project's doc/ directory.

Yes. The structured format of SYNOPSIS, OPTIONS, and other standard sections converts to Markdown headers and formatted text. Command syntax with options translates to code blocks or inline code.

References like 'see also foo(1)' are preserved as text. You can search-replace them with actual links to online man pages or your documentation after conversion.

Troff tables (.TS/.TE) convert to Markdown tables where possible. Complex tables may need manual adjustment, but simple tabular data like option lists work well.

This tool handles one man page at a time. For batch conversion of a package's man pages, process each file individually and combine them in your documentation system.

Standard man page macros (.TH, .SH, .PP, etc.) are interpreted and converted. Custom or package-specific macros may appear as raw text and need manual handling.

Very useful. Convert your project's man pages to Markdown for README files, wiki pages, or static documentation sites. Makes CLI tool documentation accessible in web format.

All processing happens in your browser. Your man page source, including internal or proprietary command documentation, never leaves your device.

Common Man Page Macros

Related Tools