Skip to main content

Write man pages using Markdown, and convert them to Roff or HTML

Project description


Write man pages using Markdown, and convert them to Roff or HTML.


$ pip install mrkd


$ mrkd my-file.1

Syntax is mrkd [options...] input-file output-file. The name and section number will automatically be derived from the input file, though you can override them using -name my-name and -section my-section, respectively.

Change the format to HTML using -format html:

$ mrkd -format html my-file.1.html

You can override the HTML template (see template.html for an example) using -template.

In order to setup HTML links, you can set up an index file like so:


Then, when you do the following in your Markdown files:

something something (see my-page(1))

mrkd will automatically pick up the link and connect it via the index file. Pass it via the -index argument:

$ mrkd -f html -index index.ini my-file.1.html

See the test directory for an example.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mrkd-0.2.0.tar.gz (6.0 kB view hashes)

Uploaded Source

Built Distribution

mrkd-0.2.0-py3-none-any.whl (8.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page