tree d2622a4ff9291e1dda8924bbc9831493242d878f
parent 96f6d5f0dd851b5a98eb88950b8ece7ed8552fa7
author Shawn Pearce <sop@google.com> 1423296624 -0800
committer Shawn Pearce <sop@google.com> 1423691718 -0800

Markdown: recognize special multi-column layout blocks

Documentation writers may want to organize clusters of information
and/or links into a multi-column based layout to help readers find
material quickly.

Extend the supported markdown syntax with a new multi-column region.
A multi-column region is delineated by |||---||| with other markdown
contained within it:

  |||---|||
  ## Markdown is easy
  You can write simple text.

  * [Basic markdown](http://...)
  * [GitHub flavor](http://github.com/...)
  * [This kind](kind.md)

  ## Safe
  No HTML found.

  ## Fast
  Well, faster than you can get coffee.
  |||---|||

Headers within the region define the columns.  For each header a new
column is started and the following content is placed below it into
the same column.

The above will render as three divs next to each other:

  Markdown is easy            Safe                 Fast

  You can write simple        No HTML found.       Well, faster than
  text.                                            you can get coffee.

  * Basic markdown
  * GitHub flavor
  * This kind

At present up to 4 columns may be fit across a page of documentation.
Additional columns should be placed into a new |||---||| block and
will appear below these columns.

The column widths are not configurable.

Change-Id: I088115bf4d4569817aca736cb0ce02f9d777d61b