Metadata-Version: 2.0
Name: mrkd
Version: 0.1.4
Summary: Write man pages using Markdown, and convert them to Roff or HTML
Home-page: https://github.com/kirbyfan64/mrkd
Author: Ryan Gonzalez
Author-email: rymg19@gmail.com
License: BSD
Keywords: man markdown roff html
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Documentation
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.6
Requires-Python: >=3.6
Description-Content-Type: text/x-markdown
Requires-Dist: Jinja2
Requires-Dist: mistune
Requires-Dist: plac
Requires-Dist: pygments

# mrkd

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

## Installation

```
$ pip install mrkd
```

## Usage

```
$ mrkd my-file.1.md 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 my-file.1.md -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:

```ini
[Index]
my-page(1)=my-page.1.html
```

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.md my-file.1.html
```

See the `test` directory for an example.


