aboutsummaryrefslogtreecommitdiff
path: root/README.html
diff options
context:
space:
mode:
Diffstat (limited to 'README.html')
-rw-r--r--README.html170
1 files changed, 170 insertions, 0 deletions
diff --git a/README.html b/README.html
new file mode 100644
index 0000000..fca665f
--- /dev/null
+++ b/README.html
@@ -0,0 +1,170 @@
+<p>
+Em is a limited hypertext markup language.
+</p>
+<p>
+It is similar to Markdown, but it has a few key advantages:
+</p>
+<ol>
+<li value="1">It is more readable.
+</li><li value="2">It is simpler to parse.
+</li><li value="3">There is <i>not</i> more than one way to do it (sorry Larry).
+</li>
+</ol>
+<p>
+Em takes plain-text readability seriously. You should be able to
+write em in a plain-text e-mail message without the recipient noticing.
+</p>
+<p>
+Em is implemented as a portable awk script, whose simplicity speaks
+for the benefits of em.
+</p>
+<h3>Syntax</h3>
+<h3>Block-level formatting</h3>
+<p>
+<i>A single empty line</i> always marks a block break. There is
+no exception to this rule. The line is removed in the final output.
+</p>
+<p>
+All blocks support inline formatting, except headings,
+preformatted blocks and terms in definition lists.
+</p>
+<p>
+One block cannot be put within another block. For example,
+it is impossible to put a paragraph or a preformatted block
+inside a list item. If you want paragraph lists, just use paragraphs:
+</p>
+<pre>
+1. Lorem ipsum dolor sit amet, consectetur adipiscing elit,
+sed do eiusmod tempor incididunt ut labore et dolore
+magna aliqua.
+</pre>
+<pre>
+2. Ut enim ad minim veniam, quis nostrud exercitation
+ullamco laboris nisi ut aliquip ex ea commodo consequat.
+</pre>
+<h4>Headings</h4>
+<p>
+Headings begin and end with the same number of equal signs:
+</p>
+<pre>
+= First-level heading =
+
+== Second-level heading ==
+</pre>
+<h4>Lists</h4>
+<p>
+Lists start with a single space. There are four types of lists:
+</p>
+<pre>
+<li>This is an unordered list
+ - With two items
+
+ 1. This is an ordered list
+ 2. With an item that spans
+two lines
+
+ this is: a definition list
+</li>
+</pre>
+<pre>
+<li value="1" id="ref1">This is a reference list
+ [2] With two items
+</li>
+</pre>
+<p>
+Unordered and ordered lists can be nested. An additional space
+at the beginning of the line increases the item level by one:
+</p>
+<pre>
+<li>First level
+ - Second level
+ - First level
+</li>
+</pre>
+<p>
+A reference list is a special type of list, unique to em. It is a
+type of footnote list, to which you can make inline referencess
+like this:
+</p>
+<pre>
+See footnote [<a href="#ref1">1</a>].
+</pre>
+<p>
+There is a special type of reference list item called a <i>hyperlink
+reference</i>. It contains only a single word, without whitespace:
+</p>
+<pre>
+</pre>
+<p>
+Hyperlink reference items are removed in the final output,
+but you can still reference them inline:
+</p>
+<pre>
+You can download the file here [<a href="#ref1">1</a>].
+</pre>
+<h4>Preformatted blocks</h4>
+<p>
+Preformatted blocks start with a single tab:
+</p>
+<pre>
+#include <stdio.h>
+ main() { puts("Hello world!\n"); }
+</pre>
+<h4>Paragraphs</h4>
+<p>
+Paragraphs start with no space:
+</p>
+<pre>
+This is a paragraph
+with two lines.
+</pre>
+<pre>
+This is another paragraph.
+</pre>
+<h3>Inline formatting</h3>
+<p>
+<b>Italic, bold and teletype text</b> is marked with the asterisk,
+the underscore and the backtick, respectively:
+</p>
+<pre>
+Example of <i>italic</i> text.
+</pre>
+<p>
+The marks are only valid in certain positions:
+</p>
+<ol>
+<li value="1">At word borders
+</li><li value="2">After an opening parenthesis
+</li><li value="3">Before any of <tt>.,:;?!)</tt>
+</li><li value="4">Before a closing parenthesis any of <tt>.,:;?!</tt>
+</li>
+</ol>
+<p>
+<b>Inline references</b> are created with square brackets:
+</p>
+<pre>
+Example of an inline reference [<a href="#ref12">12</a>].
+</pre>
+<p>
+They are valid in positions 1, 3 and 4.
+</p>
+<p>
+When referencing a hyperlink reference (see above),
+the reference is replaced with a link. For example:
+</p>
+<pre>
+It is available for download [<a href="#ref1">1</a>].
+
+ [1] v1.tgz
+</pre>
+<p>
+translates into the following HTML:
+</p>
+<pre>
+<p>It is available for download (<a href="v1.tgz">link</a>).
+</p>
+</pre>
+<p>
+The default link text ("link") can be changed by setting
+the <tt>linktext</tt> environment variable.
+</p>