2021-01-21 13:40:28 +01:00
|
|
|
<?xml version="1.0" encoding="utf-8"?>
|
|
|
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml"><head>
|
|
|
|
|
<title>.</title>
|
|
|
|
|
<style type="text/css">
|
|
|
|
|
|
|
|
|
|
* { color: #000; background: #fff; max-width: 700px; }
|
|
|
|
|
tt, pre { background: #dedede; color: #111; font-family: monospace;
|
|
|
|
|
white-space: pre; display: block; width: 100%; }
|
|
|
|
|
.indentedcode { margin-left: 2em; margin-right: 2em; }
|
|
|
|
|
.codeblock {
|
|
|
|
|
background: #dedede; color: #111; font-family: monospace;
|
|
|
|
|
box-shadow: 0 4px 8px 0 rgba(0, 0, 0, 0.2), 0 6px 20px 0 rgba(0, 0, 0, 0.19);
|
|
|
|
|
padding: 7px;
|
|
|
|
|
display: block;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
.indentedlist { margin-left: 2em; color: #000; }
|
|
|
|
|
|
|
|
|
|
span { white-space: pre; }
|
|
|
|
|
.text { color: #000; white-space: pre; background: #dedede; }
|
|
|
|
|
.colon { color: #000; background: #dedede; }
|
|
|
|
|
.note { color: #000; background: #dedede; }
|
|
|
|
|
.str { color: #000; text-decoration: underline; background: #dedede; }
|
|
|
|
|
.num { color: #000; background: #dedede; font-weight: bold; font-style: italic; }
|
|
|
|
|
.fnum { color: #000; font-weight: bold; background: #dedede; }
|
|
|
|
|
.ptr { color: #000; font-weight: bold; background: #dedede; }
|
|
|
|
|
.fetch { color: #000; font-style: italic; background: #dedede; }
|
|
|
|
|
.store { color: #000; font-style: italic; background: #dedede; }
|
|
|
|
|
.char { color: #000; background: #dedede; }
|
|
|
|
|
.inst { color: #000; background: #dedede; }
|
|
|
|
|
.defer { color: #000; background: #dedede; }
|
|
|
|
|
.imm { color: #000; font-weight: bold; background: #dedede; }
|
|
|
|
|
.prim { color: #000; font-weight: bolder; background: #dedede; }
|
|
|
|
|
|
|
|
|
|
.tt { white-space: pre; font-family: monospace; background: #dedede; }
|
|
|
|
|
|
|
|
|
|
.h1, .h2, .h3, .h4 { white-space: normal; }
|
|
|
|
|
.h1 { font-size: 125%; }
|
|
|
|
|
.h2 { font-size: 120%; }
|
|
|
|
|
.h3 { font-size: 115%; }
|
|
|
|
|
.h4 { font-size: 110%; }
|
|
|
|
|
.hr { display: block; height: 2px; background: #000000; }
|
|
|
|
|
</style>
|
|
|
|
|
</head><body>
|
2021-05-17 19:04:42 +02:00
|
|
|
<p><span class="h1">Retro's Markdown Syntax</span>
|
2021-01-21 13:40:28 +01:00
|
|
|
<br/><br/>
|
|
|
|
|
I use a variation of Markdown for writing documentation and
|
2021-05-17 19:04:42 +02:00
|
|
|
when commenting code written in Retro. The syntax is
|
2021-01-21 13:40:28 +01:00
|
|
|
described below.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h2">Basic Syntax</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Headings</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Headings start with one or more number (<span class="tt">#</span>) signs. The
|
|
|
|
|
number of number signs should correspond to the heading
|
|
|
|
|
level.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'># Heading 1</tt>
|
|
|
|
|
<tt class='indentedcode'>## Heading 2</tt>
|
|
|
|
|
<tt class='indentedcode'>### Heading 3</tt>
|
|
|
|
|
<tt class='indentedcode'>#### Heading 4</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
My Markdown does not support the alternate underline
|
|
|
|
|
format for headings.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Paragraphs & Line Breaks</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
To create paragraphs, use a blank line to separate one or
|
|
|
|
|
more lines of text.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Do not add spaces or tabs at the start of a paragraph as
|
|
|
|
|
this may cause the Markdown tools to interpret the line
|
|
|
|
|
improperly.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Line breaks are entered at the end of each line.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Emphasis</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h4">Bold</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
To make text bold, surround it with asterisks.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>The *bold* word.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h4">Italic</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
To make text italic, surround it with front slashes.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>The /italic words/.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h4">Underline</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
To underline text, surround it with underscores.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>Underline _some text_.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Horizontal Rules</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Horizontal rules can be inserted by starting a line with a
|
|
|
|
|
sequence of four or more dashes (<span class="tt">-</span>) or four or more alternating
|
|
|
|
|
dash and plus (<span class="tt">-+-+</span>) characters.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>----</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h2">Lists</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Lists start with a <span class="tt">-</span> or <span class="tt">*</span>, followed by a space, then the item
|
|
|
|
|
text. Additionally, nested lists starting with two spaces before
|
|
|
|
|
the list marker can be used.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>- this is a list item</tt>
|
|
|
|
|
<tt class='indentedcode'>- so is this</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'> - this will be indented</tt>
|
|
|
|
|
<tt class='indentedcode'> - likewise</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>- back to the standard level</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h2">Code</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Code Blocks</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Code blocks start and end with ~~~ on a line by themselves.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>Sum the values.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>~~~</tt>
|
|
|
|
|
<tt class='indentedcode'>{ #10 #20 #13 #4 #22 } #0 [ + ] a:reduce</tt>
|
|
|
|
|
<tt class='indentedcode'>~~~</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
You can also denote code by starting the line with four spaces.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'> This line will be treated as code.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Test Blocks</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
Unit testing blocks start and end with <span class="tt"></span><span class="tt"> on a line by
|
|
|
|
|
themselves.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>```</tt>
|
|
|
|
|
<tt class='indentedcode'>{ #10 #20 #13 #4 #22 } #0 [ + ] a:reduce</tt>
|
|
|
|
|
<tt class='indentedcode'>```</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h3">Inline Code</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
To mark a sequence as inline code, surround it with backticks.
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<tt class='indentedcode'>For instance, look at the value in `Compiler` to see if</tt>
|
|
|
|
|
<tt class='indentedcode'>the colon compiler is active.</tt>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
<span class="h2">Escaping</span>
|
|
|
|
|
<br/><br/>
|
|
|
|
|
You can preceed a character with a backslash () to have it
|
|
|
|
|
not be processed as a Markdown element.
|
|
|
|
|
</p>
|
|
|
|
|
</body></html>
|
