Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>I know of three main languages used commonly in the greater programming and tech community: Textile, Markdown, and reStructuredText. All three can be learned in a couple of hours or "winged" with the cheat sheet nearby.</p> <h3>Textile</h3> <ul> <li>Used by Redmine and the Ruby community</li> <li>113 questions currently tagged on Stack Overflow</li> <li>The most similar to HTML, but least readable source</li> <li>Easiest nested lists of all three languages</li> <li>Not understandable to non-programmers or the HTML-ignorant</li> <li>Ideal for complex short documents (with links, nested lists, code, custom HTML); for example: short documentation, how-tos, blog or CMS content</li> <li><a href="http://redcloth.org/hobix.com/textile/" rel="noreferrer">Syntax reference</a></li> </ul> <h3>Markdown</h3> <ul> <li>Doesn't seem to have a home language "community" but...</li> <li>1274 questions tagged on Stack Overflow*</li> <li>Emphasizes source code readability, similar to email traditions</li> <li>Straightforward HTML embedding (you just type the tags out)</li> <li>No way to make tables besides embedding HTML</li> <li>You know it already if you know Stack Overflow</li> <li>Easy to learn if you already know reStructuredText</li> <li>Automatic email address obfuscation for the format &lt;address@example.com&gt; (with angle brackets)</li> <li><a href="http://daringfireball.net/projects/markdown/syntax" rel="noreferrer">Syntax reference</a></li> </ul> <h3>reStructuredText (A.K.A. ReST)</h3> <ul> <li>Popular in the Python community</li> <li>285 questions tagged on Stack Overflow</li> <li>A bit persnickety about whitespace and alignment if you ask me</li> <li>Lists (especially nested lists) and paragraphs always seem to get in fights</li> <li>Readable by non-programmers</li> <li>Only format which can build a table of contents (via an extension in the Python reference implementation)</li> <li>Directly converts to other formats like PDF and XML</li> <li>Ideal for large documents with lots of prose (e.g. an alternative to docbook for a user manual)</li> <li><a href="http://docutils.sourceforge.net/docs/user/rst/quickref.html" rel="noreferrer">Syntax reference</a></li> </ul>
    singulars
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
    3. VO
      singulars
      1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload