News for hackers. Stuff that matters.
Re:ReStructuredText vs. Markdown for documentation by darkseas on Friday June 17, 2016 @11:15AM (#11923110)
I agree. For me, Asciidoc hits the sweet spot as it seems to have much of the simplicity of Markdown, and with the AsciiDoctor/DocBook toolchain it has the publishing power of RestructuredText.

But its tables beat both hands down. You can include a csv file with some headers or micromanage merged cells, alignment and such.

Re:ReStructuredText vs. Markdown for documentation by Nagyman on Friday June 17, 2016 @03:25PM (#11924985)
csv-table[1] is an available directive in rST for doing the same thing. It optionally supports an external file.

[1] http://docutils.sourceforge.net/docs/ref/rst/directives.html...