mad
Version:
Markdown manpages
81 lines (52 loc) • 2.18 kB
Markdown
# mad(1)
`mad(1)` is a markdown driven manual page viewer,
this makes manuals easier to _write_, _reuse_, and
_read_.
## Usage
Usage: mad <file>
Options:
-U, --update-self update mad(1) itself
-u, --update update remote mad-pages
-v, --version output cpm version
-h, --help output this help information
-l, --list list mad-pages
## Installation
Install `mad(1)` and its associated mad page.
$ make install
Uninstall both `mad(1)` and the associated mad page.
$ make uninstall
## About
I _love_ man pages, however they are annoying to write by hand,
and often converted from markdown anyway. `mad(1)` is effectively
the same idea, but write your manuals in markdown like you would anyway,
re-use them in your github readmes, wikis, or use markdown to HTML conversion
tools.
`mad(1)` pipes to `less(1)` so you get the same paging / searching
goodness that you expect from `man(1)`.
## Page repository
[mad-pages](https://github.com/visionmedia/mad-pages) is a collection of
useful mad pages such as language operator precedence tables, http status
codes, mime type tables etc. Use `mad --update` to install/re-install them.
## Page lookup
Use the __MAD_PATH__ environment variable to control
where `mad(1)` will look for a manual page.
The ".md" extension may be omitted.
For example:
MAD_PATH="/usr/share/mad:share/mad"
The following paths will always be searched:
- .
- /usr/local/share/mad
- /usr/share/mad
## Configuration
By default `mad(1)` installs and sources `/usr/local/etc/mad.conf` for its formatting. You may edit this file directly, or if you're scared of overwriting it
when updating `mad(1)` you can copy this file to something like `~/mad.conf` and `export MAD_CONFIG=~/mad.conf`.
```
heading: 1m
code: 90m
strong: 1m
em: 4m
```
## Screenshots
Jade manual:
