Usage

toc.md

toc.md is a special file for mmdoc. The order of the cross references in toc.md control the order the sections appear in the single-page HTML and ePub outputs. If a section is not referenced in toc.md it does not get included in any of the outputs.

Extensions beyond CommonMark

In order to be useful for Documentation, it uses several CommonMark extensions available in GitHub-flavored Markdown and Pandoc.

• Cross references

  Made with:

  # Heading {#heading-anchor-id}
  [inline]{#inline-anchor-id}
  

  Referenced with:

  [heading](#heading-anchor-id)
  [inline](#inline-anchor-id)
  

• GitHub tables

  | foo | bar |
  | --- | --- |
  | baz | bim |
  

• Admonitions

  ::: warning
  this is your last warning
  :::
  

  Warning

  this is your last warning

  ::: {.example #anchor}
  this is your last warning
  :::
  

  Example

  this is your last warning

• DD Lists

  term 1
  
  : defintion 1
  
  term 2
  
  : defintion 2