Hi Rob,
I have been using both, ReST and markdown for academic/scholar writing
inside and outside Leo, so here comes some comments from my experience.
- ReST, was more general and extensible, but being more pythonic used
heavily indentation to define document blocks which at some time could
be a nuance when you're trying to debug errors. It's a little bit to
learn that markdown.
- Markdown is easier to write and learn and while without a common
standard it's becoming the standard light markup for the web (GitHub,
StackOverflow, Jupyter/IPython notebook, Discuss.org and others have
support for it by default in its particular variants). With the
emergence of Pandoc's markdown[1] and scholarly markdown the
standardization and extensibility problems are being tackled by giving
it a strong community of users writing complex texts and using the light
serialization language yaml[3] for any data/feature that markdown can't
use natively.
[1] http://pandoc.org/
[2] http://scholmd.org/
[3] https://en.wikipedia.org/wiki/YAML
In the case of Leo integration I found that was easier to me made my own
custom writers/tree-traversals using markdown instead of ReST, because
of the simplicity of the former over the last.
Hope this helps,
Offray
On 25/03/16 13:07, Largo84 wrote:
Edward's recent post about simplifying Leo prompted a question that
I've had for some time. How are markdown and reStructured Text
different, and more importantly, why (or when) choose one over the
other? My guess is that they are different 'dialects' of a similar
language, but with somewhat different rules. I also notice that the
output files (@clean or @file) differ in the handling of comment
sections depending on which @language is selected; @language md
creates comments as if the file were an xml or html file, whereas
@language rest creates pure rst comments (..) Maybe it's just a
personal preference, but others' insights on reasons for their choices
would be most welcome.
Rob..........
--
You received this message because you are subscribed to the Google
Groups "leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send
an email to [email protected]
<mailto:[email protected]>.
To post to this group, send email to [email protected]
<mailto:[email protected]>.
Visit this group at https://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at https://groups.google.com/group/leo-editor.
For more options, visit https://groups.google.com/d/optout.
