forked from Gottox/smu
-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathold_readme.html
220 lines (216 loc) · 7.2 KB
/
old_readme.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
<h1>smu - a Simple Markup Language</h1>
<p><em>smu</em> is a very simple and minimal markup language. It is designed for use in
wiki-like environments. smu makes it very easy to write your documents on the
fly and convert them into HTML.</p>
<p>smu is capable of parsing very large documents. It scales just great as long
as you avoid a huge amount of indents.</p>
<h1>Syntax</h1>
<p>smu was started as a rewrite of
<a href="http://daringfireball.net/projects/markdown/">markdown</a> but became something
more lightweight and consistent. It differs from <a href="https://commonmark.org/">CommonMark</a> in the following ways:</p>
<ul>
<li>No support for <em>reference style links</em></li>
<li>Stricter indentation rules for lists</li>
<li>Lists don't end paragraphs by themselves (blank line needed)</li>
<li>Horizontal rules (<code><hr></code>) must use <code>- - -</code> as syntax</li>
<li>Code fences have stricter syntax</li>
</ul>
<p>Patches that increase the CommonMark compatibility are welcome as long as they don't increase the code complexity significantly.</p>
<p>This project is a fork of the <a href="https://github.com/gottox/smu">original smu</a> by
<a href="https://eboland.de">Enno Boland (gottox)</a>. The main differences to the
original smu are:</p>
<ul>
<li>Support for code fences</li>
<li>Improved <a href="https://commonmark.org/">CommonMark</a> compatibility. E.g.
<ul>
<li>Code blocks need four spaces indentation instead of three</li>
<li>Skip empty lines at end of code blocks</li>
<li>Ignore single spaces around code spans</li>
<li>Keep HTML comments in output</li>
<li>Improved spec compliance for lists</li>
<li>Nesting code block in blockquotes works</li>
<li>"Empty" lines in lists behave identically, no matter how much whitespace they contain</li>
</ul>
</li>
<li>Added a simple test suite to check for compliance and avoid regressions</li>
</ul>
<h2>Inline patterns</h2>
<p>There are several patterns you can use to highlight your text:</p>
<ul>
<li><p>Emphasis</p>
<ul>
<li>Surround your text with <code>*</code> or <code>_</code> to get <em>emphasised</em> text:
<pre><code>This *is* cool.
This _is_ cool, too.
</code></pre>
</li>
<li>Surround your text with <code>**</code> or <code>__</code> to get <strong>strong</strong> text:
<pre><code>This **is** cool.
This __is__ cool, too.
</code></pre>
</li>
<li>Surround your text with <code>***</code> or <code>___</code> to get <strong><em>strong and emphasised</em></strong> text:
<pre><code>This ***is*** cool.
This ___is___ cool, too.
</code></pre>
</li>
<li>But this example won't work as expected:
<pre><code>***Hello** you*
</code></pre>
<p>This is a wontfix bug because it would make the source too complex.
Use this instead:
</p>
<pre><code>***Hello*** *you*
</code></pre>
</li>
</ul>
</li>
<li><p>inline Code</p>
<p>You can produce inline code with surrounding <code>`</code> or <code>``</code></p>
<pre><code>Use `rm -rf /` if you're a N00b.
</code></pre>
<pre><code>Use ``rm -rf /`` if you're a N00b.
</code></pre>
<p>Using <code>``ABC``</code> makes it possible to use Backticks without backslashing them.</p>
</li>
</ul>
<h2>Titles</h2>
<p>Creating titles in smu is very easy. There are two different syntax styles. The
first is underlining:</p>
<pre><code>Heading
=======
Topic
-----
</code></pre>
<p>This is very intuitive and self explaining. The resulting sourcecode looks like
this:</p>
<pre><code><h1>Heading</h1>
<h2>Topic</h2>
</code></pre>
<p>Use the following prefixes if you don't like underlining:</p>
<pre><code># h1
## h2
### h3
#### h4
##### h5
###### h6
</code></pre>
<h2>Links</h2>
<p>The simplest way to define a link is with simple <code><></code>.</p>
<pre><code><http://s01.de>
</code></pre>
<p>You can do the same for E-Mail addresses:</p>
<pre><code><[email protected]>
</code></pre>
<p>If you want to define a label for the url, you have to use a different syntax</p>
<pre><code>[smu - simple mark up](http://s01.de/~gottox/index.cgi/proj_smu)
</code></pre>
<p>The resulting HTML-Code</p>
<pre><code><a href="http://s01.de/~gottox/index.cgi/proj_smu">smu - simple mark up</a></p>
</code></pre>
<h2>Lists</h2>
<p>Defining lists is very straightforward:</p>
<pre><code>* Item 1
* Item 2
* Item 3
</code></pre>
<p>Result:</p>
<pre><code><ul>
<li>Item 1</li>
<li>Item 2</li>
<li>Item 3</li>
</ul>
</code></pre>
<p>Defining ordered lists is also very easy:</p>
<pre><code>1. Item 1
2. Item 2
3. Item 3
</code></pre>
<p>It is possible to use any leading number you want. So if you don't want to keep
your list synchronised, you simple can use any number. In this case it's
recommended to use <code>0.</code>, but it isn't mandatory.</p>
<pre><code>0. Item 1
0. Item 2
0. Item 3
</code></pre>
<p>Both examples will cause the same result. Even this is possible:</p>
<pre><code>1000. Item 1
432. Item 2
0. Item 3
</code></pre>
<p>This will be the result in these example:</p>
<pre><code><ol>
<li>Item 1</li>
<li>Item 2</li>
<li>Item 3</li>
</ol>
</code></pre>
<h2>Code & Blockquote</h2>
<p>Use the <code>> </code> as a line prefix for defining blockquotes. Blockquotes are
interpreted as well. This makes it possible to embed links, headings and even
other quotes into a quote:</p>
<pre><code>> Hello
> This is a quote with a [link](http://s01.de/~gottox)
</code></pre>
<p>Result:
</p>
<pre><code><blockquote><p>
Hello
This is a quote with a <a href="http://s01.de/~gottox">link</a></p>
</blockquote>
</code></pre>
<p>You can define a code block with a leading Tab or with <strong>4</strong> leading spaces</p>
<pre><code> this.is(code)
this.is(code, too)
</code></pre>
<p>Result:
</p>
<pre><code><pre><code>this.is(code)</code></pre>
<pre><code>this.is(code, too)
</code></pre>
</code></pre>
<p>Please note that you can't use HTML or smu syntax in a code block.</p>
<p>Another way to write code blocks is to use code fences:</p>
<pre><code>```json
{"some": "code"}
```
</code></pre>
<p>This has two advantages:</p>
<ul>
<li>The optional language identifier will be turned into a <code>language-</code> class name</li>
<li>You can keep the original indentation which helps when doing copy & paste</li>
</ul>
<h2>Other interesting stuff</h2>
<ul>
<li><p>to insert a horizontal rule simple add <code>- - -</code> into an empty line:</p>
<pre><code>Hello
- - -
Hello2
</code></pre>
<p>Result:
</p>
<pre><code><p>
Hello
<hr />
</code></pre>
<pre><code>Hello2</p>
</code></pre>
</li>
<li><p>You can escape the following pattern to avoid them from being interpreted:</p>
<pre><code>\ ` * _ { } [ ] ( ) # + - . !
</code></pre>
</li>
<li><p>To force a linebreak simple add two spaces to the end of the line:</p>
<pre><code>No linebreak
here.
But here is
one.
</code></pre>
</li>
</ul>
<h2>embed HTML</h2>
<p>You can include arbitrary HTML code in your documents. The HTML will be
passed through to the resulting document without modification. This is a good
way to work around features that are missing in smu. If you don't want this
behaviour, use the <code>-n</code> flag when executing smu to stricly escape the HTML
tags.</p>