Comment on Pandoc Markdown and ReST Compared (2013)parentComments−BruceM12yI like ReST as well. With Sphinx, it is great for producing documentation. A project that I work with has converted hundreds of pages of books of technical documentation over to Sphinx and a custom Sphinx extension.−fprintf12yI like ReST as well.It's more powerful and looks much cleaner// e.g. how do you write footnotes in markdown? And how do you do this in markdown? +------------+------------+-----------+ | Header 1 | Header 2 | Header 3 | +============+============+===========+ | body row 1 | column 2 | column 3 | +------------+------------+-----------+ | body row 2 | Cells may span columns.| +------------+------------+-----------+ | body row 3 | Cells may | - Cells | +------------+ span rows. | - contain | | body row 4 | | - blocks. | +------------+------------+-----------+−mercurial12ySince basic Markdown is so basic, multiple incompatible flavours of Markdown have cropped up, including Pandoc-Markdown, which can do footnotes.−biscarch12yin pandoc-markdown a footnote[^1] would be written like this.[^1]: My footnote hereHere's a link to pandoc's markdown flavor, which includes tables: http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markd...
Comments
I like ReST as well. With Sphinx, it is great for producing documentation. A project that I work with has converted hundreds of pages of books of technical documentation over to Sphinx and a custom Sphinx extension.
I like ReST as well.
It's more powerful and looks much cleaner
// e.g. how do you write footnotes in markdown? And how do you do this in markdown?
Since basic Markdown is so basic, multiple incompatible flavours of Markdown have cropped up, including Pandoc-Markdown, which can do footnotes.
in pandoc-markdown a footnote[^1] would be written like this.
[^1]: My footnote here
Here's a link to pandoc's markdown flavor, which includes tables: http://johnmacfarlane.net/pandoc/demo/example9/pandocs-markd...