Skip to content

Instantly share code, notes, and snippets.

@weakish
Created November 16, 2016 14:56
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save weakish/0751d510b2b65be1fc1bf86c91af55d0 to your computer and use it in GitHub Desktop.
Save weakish/0751d510b2b65be1fc1bf86c91af55d0 to your computer and use it in GitHub Desktop.
common subset of #MarkDown, #ReStructedText, and #AsciiDoc
MarkDown vs. ReStructuredText vs. Asciidoc
==========================================
.::
**strong emphasis text**
``literal`` (compatible with Asciidoctor)
> blockquote is compatible with Asciidoctor,
* unordered list item
- unordered list item
1. ordered list item
---- for horizontal rule (compatible with Asciidoctor).
main title for document
========================
(see below)
title
-----------------
Compatibel with Asciidoc python,
using it implicitly set `compat-mode` in Asciidoctor,
(without new Asciidoctor syntax).
Summary
--------
.::
**storg**
* unordered list
- unordered list
1. ordered list
main title
==========
title
------
Workarounds
-----------
.::
[Link][1] will display as link in [MarkDown][2],
and literal in ReStructuredText and AsciiDoc.
[1]: http://example.com
[2]: http://example.com
ReStructuredText requires the precedding paragraph of literal block ends with `::`,
which is used to mark label list in AsciiDoc.
However, AsciiDoc allows a string beginning with dot
to specify filename of source code, which will be parsed literally.
Combining those we have .::, \n, four-spaces indented literal block.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment