plone markup

Issues with structured text

• Sections are denoted/detected by the indentation following the section title, rather than on markup around the actual section title. This makes it delicate and rather flaky in terms of it actually detecting headings in some circumstances, in particular when there were subheadings.

reStructured Text

• A ReStructuredText Primer -- decent examples
• Quick reStructuredText -- nice tables. Doesn't indicate how to do sub-lists.
• DocUtils reStructuredText -- the homepage
• rstx Markup Specification -- The full documentation on the format.
• reStructuredText Directives -- Awesome things like automatic Tables of Content
• Kevin Devon's thoughts -- One guy's thoughts. Also has some URL links I hadn't seen before

Issues with reStructured text

• No underline style? "structured" text offers: _foo_ as markup for underlined text. reStructured text does not seem to offer a markup for underlined text. --> Indeed, "Underlining is not part of the reStructuredText specification."
• Section titles require unnecessarily long markup, in this case an underline "at least as long as the section title". Ie:

this is the section title
=========================

whereas wiki requires only:

== this is the section title ==