Markdown variants usage and tools

[wassfila]

• Markdown variants
• Standardisation efforts
• Usage and popularity
• Tooling

Markup Markdown Disambiguation

• Markup is the family of languages including those using tags such as html, svg, json and others
• A sub group of Markup languages can be referred to as Lightweight Markup Language a simplified human readable format such as rst, wiki and LaTeX to cite a few.
• Markdown is an effort to create "one" particular lightweight markup language

Definitions

• https://en.wikipedia.org/wiki/Markdown
• https://www.markdownguide.org/getting-started/

Standardisation

informal, Standardisation effort, defacto standards

• informal specification : https://daringfireball.net/projects/markdown/syntax
• Common Mark Specification : https://spec.commonmark.org/
• Github Flavored Markdown : https://github.github.com/gfm/
• MarkDoc extension : https://markdoc.dev/

Variants

• https://www.markdownguide.org/extended-syntax/
• https://en.wikipedia.org/wiki/Comparison_of_document_markup_languages

Github Flavored Markdown

.md (gfm)

• https://github.github.com/gfm/

Multi Markdown

.mmd

• https://fletcherpenney.net/multimarkdown/
• https://rawgit.com/fletcher/MultiMarkdown-6-Syntax-Guide/master/index.html

Adds : footnotes, tables, citations, math,...

More Variants

• Markdown Extra : https://michelf.ca/projects/php-markdown/extra/

Lightweight Markup Variants

https://en.wikipedia.org/wiki/Lightweight_markup_language

• https://en.wikipedia.org/wiki/ReStructuredText
  .rst
  used by Python Sphynx Doc

• Jira Formatting Notation

• MediaWiki : https://en.wikipedia.org/wiki/MediaWiki#Markup

Tools

• implementations : https://github.com/markdown/markdown.github.com/wiki/Implementations
• converter : https://pandoc.org/

online

• https://dillinger.io/
• https://stripe.com/docs
• https://obsidian.md/
• https://js.wiki/
• https://ckeditor.com/

Options

• tables
• footnotes
• definition lists
• citations
• math

js libs

• (29 k) https://github.com/markedjs/marked
• (15 k) https://github.com/markdown-it/markdown-it
• (13 k) https://github.com/showdownjs/showdown
• (7 k) https://github.com/evilstreak/markdown-js
• (6 k) https://github.com/remarkjs/remark

[stereobooster]

Just in case you are curios big list of markdown parsers