mkd-extensions (7) - Linux Man Pages
mkd-extensions: Extensions to the Markdown text formatting syntax
mkd-extensions - Extensions to the Markdown text formatting syntax
DESCRIPTIONThis version of markdown has been extended in a few ways by extending existing markup, creating new markup from scratch, and borrowing markup from other markup languages.
Image dimensionsMarkdown embedded images have been extended to allow specifying the dimensions of the image by adding a new argument =/height/x/width/ to the link description.
The new image syntax is
![alt text](image =/height/x/width/ "title")
pseudo-protocolsFive pseudo-protocols have been added to links
- The alt text is marked up and written to the output, wrapped with <a id=id> and </a>
- The alt text is marked up and written to the output, wrapped with <span class=class> and </span>
- The title is written -- with no further processing -- to the output. The alt text is discarded.
- The alt text is marked up and written to the output, wrapped with <abbr title=abbr> and </abbr>
- The alt text s marked up and written to the output, wrapped with <span lang=lang> and </span>
Pandoc headersThe markdown source document can have a 3-line Pandoc header in the format of
% title % author(s) % datewhich will be made available to the Fn mkd_doc_title , Fn mkd_doc_author , and Fn mkd_doc_date functions.
Definition listsA definition list item is defined as
=tag= description(that is a = followed by text, another = a newline, 4 spaces of intent, and then more text.)
Alternatively, definition list items are defined as
tag : description(This is the format that PHP Markdown Extra uses.)
embedded stylesheetsStylesheets may be defined and modified in a <style> block. A style block is parsed like any other block level html; <style> starting on column 1, raw html (or, in this case, css) following it, and either ending with a </style> at the end of the line or a </style> at the beginning of a subsequent line.
relaxed emphasisThe rules for emphasis are changed so that a single _ will not count as a emphasis character if it's in the middle of a word. This is primarily for documenting code, if you don't wish to have to backquote all code references.
alpha listsAlphabetic lists (like regular numeric lists, but with alphabetic items) are supported. So:
a. this b. is c. an alphabetic d. listwill produce:
<ol type=a> <li>this</li> <li>is</li> <li>an alphabetic</li> <li>list</li> </ol>
tablesPHP Markdown Extra tables are supported; input of the form
header|header ------|------ text | textwill produce:
<table> <thead> <tr> <th>header</th> <th>header</th> </tr> </thead> <tbody> <tr> <td>text</td> <td>text</td> </tr> </tbody> </table>The dashed line can also contain : characters for formatting; if a : is at the start of a column, it tells discount to align the cell contents to the left; if it's at the end, it aligns right, and if there's one at the start and at the end, it centers.