MMD, like the original Markdown, is intended for writing plain-text documentation which is highly readable in source form, and is also very easy to translate to formatted text. MMD translates to HTML.
MMD is inspired by HBolio which I wrote some years past. The new development was partly to allow better handling of text styles using flag characters, and partly as an exercise to discover whether I still know how to program. (It turns out that I do, albeit with careless mistakes.)
MMD processes input a line at a time. Each line is classified as an ordinary, blank, list, table, directive, or directed line.
A blank line indicates a paragraph boundary.
A list, table, or directive line is identified by its first character:
|*||bulleted list line|
|#||numbered list line|
||||table line (must also end with |)|
After the dot, a directive line contains the name of the directive. See Directives for a description of each directive. If there is anything non-blank on the line after the directive name, it is a directed line of that type. Otherwise, lines following the directive line are directed lines of that type, up to a line containing .end name.
For readability, the * or # at the beginning of a list line can be preceded by spaces.
The * or # at the beginning of a list line can be repeated to indicate nesting. Thus:
* first bullet ** sub-bullet ** another sub-bullet *** sub-sub-bullet * second bullet # number one ## nested number one ## nested number two ### doubly nested ## nested again # number twoformats as:
A line that begins and ends with a | character is a table line. It formats as one row of a table. | separates columns.
| characters can be surrounded by white space for readability. It has no effect on the formatted output.
|| is used in a heading row.
|| Column One || Column Two || Column Three || | A | B | C | | 123 | 456 | 789 |formats as:
|Column One||Column Two||Column Three|