theme: style and document markdown extensions

[McShelby]

Available but untested and undocumented markdown features:

• task lists
• defintion lists
• punctuation substitution
• footnotes
• table alignment