[ofiwg] creating a table with markdown

Jason Gunthorpe jgunthorpe at obsidianresearch.com
Wed Jan 7 11:48:03 PST 2015


On Wed, Jan 07, 2015 at 06:55:30PM +0000, Jeff Squyres (jsquyres) wrote:
> On Jan 7, 2015, at 1:51 PM, Jason Gunthorpe <jgunthorpe at obsidianresearch.com> wrote:
> 
> > I've been using RST for awhile to write man pages - the rst2man
> > converter in docutils does a reasonable job and RST is a bit richer
> > and more well defined that markdown, while being similarly simplistic.
> 
> FWIW, we chose to use markdown because it plays well in the github
> environment.  E.g., markdown is natively rendered as web pages in
> the github web page-hosting environment.

I thought github supported rst? The docs say that at least:

https://github.com/github/markup

We use this library on GitHub when rendering your README or any other
rich text file. The generated HTML is then run through filters in the
html-pipeline to perform things like sanitization and syntax
highlighting.

The following markups are supported. 
 * .rst -- easy_install docutils

-- 
Jason Gunthorpe <jgunthorpe at obsidianresearch.com>        (780)4406067x832
Chief Technology Officer, Obsidian Research Corp         Edmonton, Canada



More information about the ofiwg mailing list