titles are linked to relevant sections of the comprehensive reference
Paragraphs are separated
by a blank line.
This is a separate paragraph.
*italic* or **bold**
~weak~ or ~~struck through~~
here comes a block separator
**********************
=====================
Overlined Heading
=====================
Underlined Heading
------------------------
*** Embedded Heading *********
:::::::::::: Embedded Heading
Embedded Heading #############
http://www.example.com/autolinks
www.example.com
mail@example.com
<example.com/delimited-link>
[show this text instead of the URL](http://www.example.com/)
[keyed reference][key]
[key]: http://www.example.com/
[implicit reference]
[implicit reference]: http://www.example.com/
[click this text to run command](% command)
- a list item
- another item
1. a nested numbered list
2. second item
- and another
term
: description
another paragraph of description
`inline verbatim`
a verbatim block
is just some indented text
``````````````````````````
a delimited verbatim block
``````````````````````````
"All is metaphor." --R.A.W.
> e-mail quotation
>
> > it can be nested
{http://www.example.com/image.jpg}
{/example.txt}
{sub}
[sub]: this text replaces all instances of {sub} (no recursion)
{% replaced-with-output-of-this-command}
right centre left
---------+ ------+------ +--------
explicit alignment markers
odd 3n even
------- --------- -------
right centre left
*adjacent to inline elements*{#id .class name="value" ref}
separated from block elements (like this paragraph)
by white space, at least one space {#id}
separated from block elements (like this paragraph)
by white space, up to one blank line
{ref}
[ref]: {#id .class name="value" non-recursive-ref}
[inline container]{#id}
====================
block container
==========={#id}===
Notes can be useful.*[key]
[key]: There are other kinds of notes, not just footnotes.
[I’m still refining the form of input elements, mostly the short-form syntax (which is not shown here) and rules of inference, rather than the explicit syntax.]
inline text input: [_default text____]<-{#name}
password: [_________]<-{#name .obscured}
=============================
text block input
(like HTML textarea)
==================== <-{#name} ===
[ ]<-{#name} - a true/false check box
[ ]<-{value=1 name=a} - multi-value check boxes
[ ]<-{value=2 name=a} - share a common name
[x]<-{value=3 name=a} - this one is checked
( )<-{value=1 name=a} - radio buttons
( )<-{value=2 name=a} - also share a common name
(x)<-{value=3 name=a} - this one is checked
[ one two three another ]<-{#name} - a menu
[;one;*selected*;this item has spaces;]<-{#name}
[,group one (:a:b:),group two (:*c*:d:),]<-{#name}
[ *a* b *c* d ]<={#name} - multi-selection (<= not <-)
[<...]<-{#name} file input
no \*italic\* here
[RTFM]: (Read The Fair Manual)
% name: value