Proposed Extensions to CommonMark

Terminology

flavor, variant, dialect, syntactic sugar, extension, plug-in, add-on …

Concepts described on separate pages

• Generic Directive Extension List

Critic Markup

http://criticmarkup.com

deletion

change (removal/replacement)

addition

highlighting

comment

Marked Text

Strike-through

Underlines

Line Breaks

Links

Link Syntax Sugar

automatic IDs

Implicit Shortcut Links

Shortcut Reference Links

Notes

footnotes / endnotes

marginnotes / sidenotes / asides

slidenotes

tooltips

Spoiler Warnings, hidden answers

Paragraph Types or Classes

General and Scientific Articles, Reports and Books

abstract, introduction/lede, byline, …

Textbook boxes, Blurbs

warning, tip, error, information, question, discussion, exercise https://leanpub.com/markua/read#leanpub-auto-blurbs

Science

definition, law, lemma, corollary, hypothesis, theorem, proof

Other

commentary (not the same as comments), pull-quote

Slide Presentations

slide titles

slide breaks

transitions

sequential uncovering

presenter notes

Paged Media

running header

page numbers

see [Book Structure]

page breaks / pagination

page number references

Book Structure

cover, frontmatter, preface, introduction

mainmatter

backmatter, appendices, imprint

Metadata

Global Document Metadata

attributes, parameters

labels and identifiers

Floats

Captions

Figures

Indices

Table of Contents (TOC) = list of headings

list of figures/floats (LOF), list of tables (LOT) = list of captions

list of code listings, list of equations …

Index ≈ list of Terms and Definitions

Terms and Definitions

Abbreviations and Acronyms

and expansions thereof

Technical and Legal Terms

Lists

Glossaries

Definition Lists

FAQ Lists / Q&A

Pro-Con Lists, Feature lists, Changelog

Numbered Examples

Tables

Cells

Rows

Columns

Column Headers

Row Headers

Horizontal Alignment

Block Cell Content

Cells spanning several Columns

Cells spanning several Rows

Caption

CSV

Incorporated Resources

Media Files embedded

audio, video, YouTube, …

includes, transclusions

External Code Samples

Style

templates (layout, variables), designs, themes (colors, pictures), skins

Forms

Static Forms, Questionnaire

Interactive Forms

Checkbox Widget

Radio Button Widget

Line Input Widget

Password Input Widget

Email Input Widget

Date and Time Input Widgets

Color Input Widget

Math

Inline Math, Formulas

Display Math, Equations

Numbers and Units, Values

Symbols

Diagrams

Tree Diagrams, Grammars

Charts

Plots

Graphs

Mind Maps

ASCII Art

References

Citations

Bibliography = list of references

User Names (mentions)

Tags and Categories, Keywords

Symbols

Named Character References

Entities

Numeric Unicode Position References

Escapes

Symbolic References

Emoji/Emoticons