Re: 2015: reStructuredText implementations in other programming languages?

Kevin Horn <[email protected]>
Newsgroups gmane.text.docutils.user
Message-ID <CA+U=zK1P_V7LJa1jB51JE5TKp6G5jYyO06E4dXronh2_yRLbFw@mail.gmail.com>
@Skip

IMO, RestructuredText and Markdown fill different niches.  Markdown really
targets HTML output and is quite limited when talking about other output
formats.  This is mainly because it only supports a limited group of
document elements.  If you need something outside this set of elements, the
Markdown way of handling this is to insert raw html.  This really makes
markdown only suitable for (relatively) simple documents or documents that
will be turned into HTML.

RestructuredText tries much harder to support whatever type of document
element you happen to need, and if one isn't supported, it has built in
extension mechanisms (custom directives/roles) which you can use.  This
allows it to be much more useful if you want to support non-HTML output
formats.

There's room for both in the ecosystem, as they do different things (though
there is some overlap).

As far as Markdown taking over, I would say that both have experienced
quite a bit of growth in the last few years, Markdown mostly being used for
simple documents, and HTML fragments (thinking comments here), and
RestructuredText getting a lot of use and exposure via Sphinx (which is
used for lots of projects even outside the Python community).


On Wed, Apr 22, 2015 at 8:20 AM, Skip Montanaro <[email protected]> wrote:

> 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
>
>
>
> ------------------------------------------------------------------------------
> BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
> Develop your own process in accordance with the BPMN 2 standard
> Learn Process modeling best practices with Bonita BPM through live
> exercises
> http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual-
> event?utm_
> source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
> _______________________________________________
> Docutils-users mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/docutils-users
>
> Please use "Reply All" to reply to the list.
>
>


-- 
--
Kevin Horn

------------------------------------------------------------------------------
BPM Camp - Free Virtual Workshop May 6th at 10am PDT/1PM EDT
Develop your own process in accordance with the BPMN 2 standard
Learn Process modeling best practices with Bonita BPM through live exercises
http://www.bonitasoft.com/be-part-of-it/events/bpm-camp-virtual- event?utm_
source=Sourceforge_BPM_Camp_5_6_15&utm_medium=email&utm_campaign=VA_SF
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.