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
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
{% extends "base_content.html" %}
{% load extra_tags %}
{% load humanize %}
{% load i18n %}
{% block fulltitle %}{% spaceless %}{% trans "Markdown Help" %}{% endspaceless %}{% endblock %}
{% block forejs %}
<link rel="stylesheet" type="text/css" media="all" href="{% media "/media/style/markdown_help.css" %}" />
{% endblock %}
{% block content %}
<div id="main-wrapper"><br /><br />
<div id="heading">
<h1>{% trans "Markdown Syntax" %}</h1>
<p>{% blocktrans %}This document describes some of the more important parts of Markdown (for writers, that is). There's a lot more to the syntax than is mentioned here, though. To get the full syntax documentation, go to John Gruber's <a href="http://daringfireball.net/projects/markdown/syntax" rel="nofollow">Markdown Syntax</a> page{% endblocktrans %}</p>
</div>
<div class="section">
<h2 class="section-title">{% trans "Headers" %}</h2>
<div class="section-description">
{% trans "For top-level headers underline the text with equal signs. For second-level headers use dashes to underline." %}
</div>
<table class="section-example"><tr>
<td>
<code>{% trans "This is an H1" %}</code><br />
<code>============= </code>
</td>
<td>
<h1>{% trans "This is an H1" %}</h1>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>{% trans "This is an H2" %}</code><br />
<code>-------------</code>
</td>
<td>
<h2>{% trans "This is an H2" %}</h2>
</td>
</tr></table>
<div class="section-description">
{% blocktrans %}If you would rather, you can prefix headers with a hash (#) symbol instead. The number of hash symbols indicates the header level. For example, a single hash indicates a header level of one while two indicates the second header level:{% endblocktrans %}
</div>
<table class="section-example"><tr>
<td>
<code># {% trans "This is an H1" %}</code>
</td>
<td>
<h1>{% trans "This is an H1" %}</h1>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>## {% trans "This is an H2" %}</code>
</td>
<td>
<h2>{% trans "This is an H2" %}</h2>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>### {% trans "This is an H3" %}</code>
</td>
<td>
<h3>{% trans "This is an H3" %}</h3>
</td>
</tr></table>
<div class="section-description">
{% trans "Which you choose is a matter of style. Whichever you thinks looks better in the text document. In both cases, the final, fully formatted, document looks the same." %}
</div>
</div>
<div class="section">
<h2 class="section-title">{% trans "Paragraphs" %}</h2>
<div class="section-description">
{% trans "Paragraphs are surrounded by blank lines." %}
</div>
<div class="section-example">
<code>{% trans "This is paragraph one." %}</code>
</div><br />
<div class="section-example">
<code>{% trans "This is paragraph two." %}</code>
</div>
</div>
<div class="section">
<h2 class="section-title">{% trans "Links" %}</h2>
<div class="section-description">
{% blocktrans %}
There are two parts to every link.
The first is the actual text that the user will see and it is surrounded by brackets.
The second is address of the page you wish to link to and it is surrounded in parenthesis.
{% endblocktrans %}
</div>
<table class="section-example"><tr>
<td>
<code>[{% trans "link text" %}]({% trans "http://example.com/" %})</code>
</td>
<td>
<a>{% trans "link text" %}</a>
</td>
</tr></table>
</div>
<div class="section">
<h2 class="section-title">{% trans "Formatting" %}</h2>
<div class="section-description">
{% trans "To indicate bold text surround the text with two star (*) symbols or two underscore (_) symbols:" %}
</div>
<table class="section-example"><tr>
<td>
<code>**{% trans "This is bold" %}**</code>
</td>
<td>
<strong>{% trans "This is bold" %}</strong>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>__{% trans "This is also bold" %}__</code>
</td>
<td>
<strong>{% trans "This is also bold" %}</strong>
</td>
</tr></table>
<div class="section-description">
{% trans "To indicate italicized text surround the text with a single star (*) symbol or underscore (_) symbol:" %}
</div>
<table class="section-example"><tr>
<td>
<code>*{% trans "This is italics" %}*</code>
</td>
<td>
<i>{% trans "This is italics" %}</i>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>_{% trans "This is also italics" %}_</code>
</td>
<td>
<i>{% trans "This is also italics" %}</i>
</td>
</tr></table>
<div class="section-description">
{% trans "To indicate italicized and bold text surround the text with three star (*) symbol or underscore (_) symbol:" %}
</div>
<table class="section-example"><tr>
<td>
<code>***{% trans "This is bold and italics" %}***</code>
</td>
<td>
<strong><i>{% trans "This is bold and italics" %}</i></strong>
</td>
</tr></table>
<table class="section-example"><tr>
<td>
<code>___{% trans "This is also bold and italics" %}___</code>
</td>
<td>
<strong><i>{% trans "This is also bold and italics" %}</i></strong>
</td>
</tr></table>
</div>
<div class="section">
<h2 class="section-title">{% trans "Blockquotes" %}</h2>
<div class="section-description">
{% trans "To create an indented area use the right angle bracket (>) character before each line to be included in the blockquote." %}
</div>
<table class="section-example"><tr>
<td>
<code>> {% trans "This is part of a blockquote." %}</code><br />
<code>> {% trans "This is part of the same blockquote." %}</code>
</td>
<td>
<p style="padding-left:15px;">{% trans "This is part of a blockquote." %}<br />{% trans "This is part of the same blockquote." %}</p>
</td>
</tr></table>
<div class="section-description">
{% trans "Rather than putting it in front of each line to include in the block quote you can put it at the beginning and end the quote with a newline." %}
</div>
<table class="section-example"><tr>
<td>
<code>> {% trans "This is part of a blockquote." %}</code><br />
<code>{% trans "This continues the blockquote even though there's no bracket." %}</code><br /><br />
<code>{% trans "The blank line ends the blockquote." %}</code>
</td>
<td>
<p style="padding-left:15px;">{% trans "This is part of a blockquote." %} <br /> {% trans "This continues the blockquote even though there's no bracket." %}</p>
<p>{% trans "The blank line ends the blockquote." %}</p>
</td>
</tr></table>
</div>
<div class="section">
<h2 class="section-title">{% trans "Lists" %}</h2>
<div class="section-description">
{% trans "To create a numbered list in Markdown, prefix each item in the list with a number followed by a period and space. The number you use actually doesn't matter." %}
</div>
<table class="section-example"><tr>
<td>
<code>1. {% trans "Item" %} 1</code><br />
<code>2. {% trans "Item" %} 2</code><br />
<code>3. {% trans "Item" %} 3</code>
</td>
<td>
<ol>
<li>{% trans "Item" %} 1</li>
<li>{% trans "Item" %} 2</li>
<li>{% trans "Item" %} 3</li>
</ol>
</td>
</tr></table>
<div class="section-description">
{% trans "To create a bulleted list, prefix each item in the list with a star (*) character." %}
</div>
<table class="section-example"><tr>
<td>
<code>* {% trans "A list item" %}</code><br />
<code>* {% trans "Another list item" %}</code><br />
<code>* {% trans "A third list item" %}</code>
</td>
<td>
<ul>
<li>{% trans "A list item" %}</li>
<li>{% trans "Another list item" %}</li>
<li>{% trans "A third list item" %}</li>
</ul>
</td>
</tr></table>
</div>
<div class="section">
<h2 class="section-title">{% trans "A Lot More" %}</h2>
<div class="section-description">{% blocktrans %}There's a lot more to the Markdown syntax than is mentioned here. But for creative writers, this covers a lot of the necessities. To find out more about Markdown than you'd ever want to really know, <a href="http://daringfireball.net/projects/markdown/syntax" target="_blank" rel="nofollow">go to the Markdown page where it all started</a>.{% endblocktrans %}</div>
</div>
</div>
{% endblock %}