Flavored Markdown


#1

Continuing the discussion from What changed in Standard Markdown?:

I’ve started work on this as http://flavoredmarkdown.com - pull requests / issues can be listed on GitHub at http://github.com/flmd/flmd.github.io/.

Right now, I’ve included:

  • The original loose Markdown specification (classified here as “gruber”, in the “K&R C”/“Thompson shell” tradition of naming loose original standards after their author)
  • Standard Markdown (currently called “standard”, although that might be moved if this gets contentious enough - it would be better if an organization like IETF, ECMA, or ANSI could back it- think ANSI C)
  • vfmd (another existing spec for Markdown)
  • GitHub Flavored Markdown (nominally based on Gruber, we’ll see if that changes)

Right now, I’m just hyperlinking to each standard: the competing standards (Gruber, stmd, vfmd) can each have a separate and unrelated document with the exact specifications from upstream.

The goal is to have the derivative “flavors” (such as GFM) explicitly state what standard they’re basing their standard on, and to list the changes they make, for other implementations to copy, and for other flavors to themselves base their variations on.


#2

Right now, the flavors are sorted alphabetically: GitHub Flavored Markdown comes first, followed by Gruber, then Standard and vfmd. That’s not really intentional, and more a side-effect of how I’ve initially organized them in Jekyll. I might redo this later with a manual ordering, or something like that: if anybody wants to contribute some way of sorting the flavors according to a value in their frontmatter, I’ll probably merge it.