Re: [Docutils-users] 2015: reStructuredText implementations in other programming languages?

[Zeth <the...@gm...>]

Markdown is the VHS of the plain text world. RST is the Betamax,
technically superior but lower adoption.

The Tables in RST are far superior, especially since they are natively
supported by Emacs Table Mode (which comes by default in Emacs 25?
24.x? Cannot remember which exactly).

I think one of the reasons Markdown often wins out is that Markdown's
inline links are much quicker for people used to HTML or Wikis to
understand.

RST's link format is superior in that the reference style links look
nicer in the textual format of the document, but that is kinda Betamax
again, most people using a plain text format are doing small textbox
style editing rather than writing a whole document.

RST and the docutils setup are better for longer texts or documentation.

On 23 April 2015 at 23:21, Philipp A. <fly...@we...> wrote:
> Skip Montanaro <sk...@po...> schrieb am Mi., 22. Apr. 2015 um 15:21 Uhr:
>>
>> Hasn't Markdown kind of taken over the marked-up-text world these days? Or
>> is that just how it appears since that's what Github supports?
>>
>> Skip
>
>
> it certainly has taken over the *non-semantic* world.
>
> reddit comments, readmes, forums, bug trackers.
>
> but i real documents, rST’s flexibility is unparalleled. except for LaTeX,
> which is a programming language and therefore has to be executed.
>
> an example where rST is perfect:
> http://flask.pocoo.org/docs/0.10/quickstart/#a-minimal-application
>
> https://github.com/mitsuhiko/flask/blob/master/docs/quickstart.rst
>
> the roles :class:, :meth:, :file:, :command:, :option:, :exc:, :attr:, … all
>  semantically define what the text is, and allow independent styling, links
> to the official python docs, other project’s docs (e.g. werkzeug), and other
> parts of the same docs.
>
> the same can be applied to blocks. rST also knows citations, …
>
> ------------------------------------------------------------------------------
> One dashboard for servers and applications across Physical-Virtual-Cloud
> Widest out-of-the-box monitoring support with 50+ applications
> Performance metrics, stats and reports that give you Actionable Insights
> Deep dive visibility with transaction tracing using APM Insight.
> http://ad.doubleclick.net/ddm/clk/290420510;117567292;y
> _______________________________________________
> Docutils-users mailing list
> Doc...@li...
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>