mandown

Documentation system using Markdown.

mandown allows you to document a library using markdown and convert it to a JSON structure that can be rendered, searched and managed easily. This library contains the necessary functionality to work with mandown and convert a file tree of markdown files into one JSON.

Structure

Generally you'll document a single class or function in its own markdown file, and follow the mandown structure for what it should contain. This begins with a top-level header ("h1") with the class the file documents:

# class my_lib::my_class

When this is set, everything "under" this h1 will be part of this class (or function). You can then add any of the following second-level headers (h2's), each with their own specific requirements:

Headers

Describe the header (or list of header files by writing them after each other with a space in-between each):

## Header mylib/my_class.hpp mylib/mylib.hpp

Definition

This is a section which can contain text and code. You can describe the function or class declaration.

## Definition
 
\```c++
template< class T > class my_class_template;
\```

Description

This section contains a description of the class or function. Its purpose and how to use it.

## Description
 
`mylib::my_class_template` wraps a value to be used for ...