Markdown is an easy to learn and versatile. The list possible formatting is quite comprehensive:

"Markdown may not be the right format for you if you find these elements not enough for your writing:

• paragraphs,
• (section) headers,
• block quotations,
• code blocks,
• (numbered and unnumbered) lists,
• horizontal rules,
• tables,
• inline formatting (emphasis, strikeout, superscripts, subscripts, verbatim, and small caps text),
• LaTeX math expressions,
• equations,
• links,
• images,
• footnotes,
• citations,
• theorems,
• proofs, and
• examples."Bookdown.
  
  

In exceptional circumstances additional formatting tricks can be pulled in as HTML code.

YAML header

Markdown allows headers to pass metadata about a file (e.g. title, author) in a YAML to processes working on the source text; the format is flexibleBut beware of colons, quotes etc.!

.

Markdown can include images, reference etc.

Markdown allow the inclusion of images, bibliographic references etc. These additional files are stored in resources directoriesresources is a reserved word; all other directory names are treated as content directories

.

References are always absolute with respect to the rootstarting with a "/"

or relative to the current pagenot starting with "/"

.