Convert MAN to MD
Turn MAN files into Markdown. GitHub Markdown with the title, section and header fields in a YAML block at the top, sections as headings, tagged paragraphs as definition lists, bold and italic fonts, examples as code and tables kept.
Converted in an isolated sandbox on our serversDeleted after 24 hours
Drop MAN files on the dialor turn it to pick what to do
Unix manual pages as Markdown.Headings, lists and code come across as GitHub Markdown.
What you get
One MD file in GitHub Markdown. The title, section and header fields from the man page go into a YAML block at the top of the file.
Sections become headings. Examples become code, and tables are kept as tables.
How the text is marked up
Tagged paragraphs become definition lists, so an option and its description stay together. Bold and italic fonts in the man page stay bold and italic in the Markdown.
Pages in mdoc
Pages written in the BSD mdoc macros keep only their running text. The structure that the macros describe is not carried over in the same way as for other man pages.
MAN and MD.What each format is.
The formats
Man Page
Unix manual pages in troff.
- Extensions
- .man
- MIME type
- text
/troff - Kind
- Text and data
Markdown
Plain text with light markup for headings, lists, links and code. What agents and developers write in.
- Extensions
- .md .markdown .mdown
- MIME type
- text
/markdown - Kind
- Text and data
In your code.The same MAN to MD conversion through the API, for your app or your agent.
$ cv convert report.man report.md$ cv convert report.man report.mdQuestions.What people ask about MAN to MD.
They go into a YAML block at the top of the MD file, together with the header fields.
Yes. Tables are kept, and examples become code.
Only in part. These pages keep their running text and little else.
Yes. MD to MAN goes the other way.