121 | 122 | Markdown can be configured to produce HTML-style tags; e.g.: 123 | 124 |
125 | 126 | 127 | ### Movable Type ### 128 | 129 | You need to use a special `MTMarkdownOptions` container tag in each 130 | Movable Type template where you want HTML 4-style output: 131 | 132 |
` tags 202 | are now ignored. 203 | 204 | + Inline links using `<` and `>` URL delimiters weren't working: 205 | 206 | like [this](
` tag. 237 | 238 | + Fix for horizontal rules preceded by 2 or 3 spaces. 239 | 240 | + `
` HTML tags in must occur within three spaces of left 241 | margin. (With 4 spaces or a tab, they should be code blocks, but 242 | weren't before this fix.) 243 | 244 | + Capitalized "With" in "Markdown With SmartyPants" for 245 | consistency with the same string label in SmartyPants.pl. 246 | (This fix is specific to the MT plug-in interface.) 247 | 248 | + Auto-linked email address can now optionally contain 249 | a 'mailto:' protocol. I.e. these are equivalent: 250 | 251 |
` tags.
256 |
257 | + You can now write empty links:
258 |
259 | [like this]()
260 |
261 | and they'll be turned into anchor tags with empty href attributes.
262 | This should have worked before, but didn't.
263 |
264 | + `***this***` and `___this___` are now turned into
265 |
266 | this
267 |
268 | Instead of
269 |
270 | this
271 |
272 | which isn't valid. (Thanks to Michel Fortin for the fix.)
273 |
274 | + Added a new substitution in `_EncodeCode()`: s/\$/$/g; This
275 | is only for the benefit of Blosxom users, because Blosxom
276 | (sometimes?) interpolates Perl scalars in your article bodies.
277 |
278 | + Fixed problem for links defined with urls that include parens, e.g.:
279 |
280 | [1]: http://sources.wikipedia.org/wiki/Middle_East_Policy_(Chomsky)
281 |
282 | "Chomsky" was being erroneously treated as the URL's title.
283 |
284 | + At some point during 1.0's beta cycle, I changed every sub's
285 | argument fetching from this idiom:
286 |
287 | my $text = shift;
288 |
289 | to:
290 |
291 | my $text = shift || return '';
292 |
293 | The idea was to keep Markdown from doing any work in a sub
294 | if the input was empty. This introduced a bug, though:
295 | if the input to any function was the single-character string
296 | "0", it would also evaluate as false and return immediately.
297 | How silly. Now fixed.
298 |
299 |
300 |
301 | Donations
302 | ---------
303 |
304 | Donations to support Markdown's development are happily accepted. See:
305 |
<< 访问主页
13 | 14 |声明： 这份文档派生(fork)于繁体中文版，在此基础上进行了繁体转简体工作，并进行了适当的润色。此文档用 Markdown 语法编写，你可以到这里查看它的源文件。「繁体中文版的原始文件可以查看这里」--By @riku / 获取 Linode VPS
15 | 16 |注： 本项目托管于 GitHub上，请通过"派生"和"合并请求"来帮忙改进本项目。
17 | 18 |Markdown: Basics （快速入门） / (点击查看完整语法说明)
19 | 20 |Getting the Gist of Markdown's Formatting Syntax
21 | 22 |此页提供了 Markdown 的简单概念， 语法说明 页提供了完整详细的文档，说明了每项功能。但是 Markdown 其实很简单就可以上手，此页文档提供了一些范例，并且每个范例都会提供输出的 HTML 结果。
23 | 24 |其实直接试试看也是一个很不错的方法， Dingus 是一个网页应用程序，你可以把自已编写的 Markdown 文档转成 XHTML。
25 | 26 |段落、标题、区块代码
27 | 28 |一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。
29 | 30 |Markdown 支持两种标题的语法，Setext 和 atx 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。
区块引用则使用 email 形式的 '>' 角括号。
Markdown 语法:
35 | 36 |A First Level Header
37 | ====================
38 | A Second Level Header
39 | ---------------------
40 |
41 | Now is the time for all good men to come to
42 | the aid of their country. This is just a
43 | regular paragraph.
44 |
45 | The quick brown fox jumped over the lazy
46 | dog's back.
47 | ### Header 3
48 |
49 | > This is a blockquote.
50 | >
51 | > This is the second paragraph in the blockquote.
52 | >
53 | > ## This is an H2 in a blockquote
54 | 输出 HTML 为：
57 | 58 |<h1>A First Level Header</h1>
59 | <h2>A Second Level Header</h2>
60 | <p>Now is the time for all good men to come to
61 | the aid of their country. This is just a
62 | regular paragraph.</p>
63 | <p>The quick brown fox jumped over the lazy
64 | dog's back.</p>
65 | <h3>Header 3</h3>
66 | <blockquote>
67 | <p>This is a blockquote.</p>
68 | <p>This is the second paragraph in the blockquote.</p>
69 | <h2>This is an H2 in a blockquote</h2>
70 | </blockquote>
71 | 修辞和强调
74 | 75 |Markdown 使用星号和底线来标记需要强调的区段。
76 | 77 |Markdown 语法:
78 | 79 |Some of these words *are emphasized*.
80 | Some of these words _are emphasized also_.
81 | Use two asterisks for **strong emphasis**.
82 | Or, if you prefer, __use two underscores instead__.
83 | 输出 HTML 为:
86 | 87 |<p>Some of these words <em>are emphasized</em>.
88 | Some of these words <em>are emphasized also</em>.</p>
89 | <p>Use two asterisks for <strong>strong emphasis</strong>.
90 | Or, if you prefer, <strong>use two underscores instead</strong>.</p>
91 | 列表
94 | 95 |无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号：
96 | 97 |* Candy.
98 | * Gum.
99 | * Booze.
100 | 加号：
103 | 104 |+ Candy.
105 | + Gum.
106 | + Booze.
107 | 和减号
110 | 111 |- Candy.
112 | - Gum.
113 | - Booze.
114 | 都会输出 HTML 为：
117 | 118 |<ul>
119 | <li>Candy.</li>
120 | <li>Gum.</li>
121 | <li>Booze.</li>
122 | </ul>
123 | 有序的列表则是使用一般的数字接着一个英文句点作为项目标记：
126 | 127 |1. Red
128 | 2. Green
129 | 3. Blue
130 | 输出 HTML 为：
133 | 134 |<ol>
135 | <li>Red</li>
136 | <li>Green</li>
137 | <li>Blue</li>
138 | </ol>
139 | 如果你在项目之间插入空行，那项目的内容会用 <p> 包起来，你也可以在一个项目内放上多个段落，只要在它前面缩排 4 个空白或 1 个 tab 。
* A list item.
144 | With multiple paragraphs.
145 |
146 | * Another item in the list.
147 | 输出 HTML 为：
150 | 151 |<ul>
152 | <li><p>A list item.</p>
153 | <p>With multiple paragraphs.</p></li>
154 | <li><p>Another item in the list.</p></li>
155 | </ul>
156 | 链接
159 | 160 |Markdown 支援两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用角括号来把文字转成连结。
161 | 162 |行内形式是直接在后面用括号直接接上链接：
163 | 164 |This is an [example link](http://example.com/).
165 | 输出 HTML 为：
168 | 169 |<p>This is an <a href="http://example.com/">
170 | example link</a>.</p>
171 | 你也可以选择性的加上 title 属性：
174 | 175 |This is an [example link](http://example.com/ "With a Title").
176 | 输出 HTML 为：
179 | 180 |<p>This is an <a href="http://example.com/" title="With a Title">
181 | example link</a>.</p>
182 | 参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容：
185 | 186 |I get 10 times more traffic from [Google][1] than from
187 | [Yahoo][2] or [MSN][3].
188 |
189 | [1]: http://google.com/ "Google"
190 | [2]: http://search.yahoo.com/ "Yahoo Search"
191 | [3]: http://search.msn.com/ "MSN Search"
192 | 输出 HTML 为：
195 | 196 |<p>I get 10 times more traffic from <a href="http://google.com/"
197 | title="Google">Google</a> than from <a href="http://search.yahoo.com/"
198 | title="Yahoo Search">Yahoo</a> or <a href="http://search.msn.com/"
199 | title="MSN Search">MSN</a>.</p>
200 | title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写：
203 | 204 |I start my morning with a cup of coffee and
205 | [The New York Times][NY Times].
206 |
207 | [ny times]: http://www.nytimes.com/
208 | 输出 HTML 为：
211 | 212 |<p>I start my morning with a cup of coffee and
213 | <a href="http://www.nytimes.com/">The New York Times</a>.</p>
214 | 图片
217 | 218 |图片的语法和链接很像。
219 | 220 |行内形式（title 是选择性的）：
221 | 222 |
223 | 参考形式：
226 | 227 |![alt text][id]
228 |
229 | [id]: /path/to/img.jpg "Title"
230 | 上面两种方法都会输出 HTML 为：
233 | 234 |<img src="/path/to/img.jpg" alt="alt text" title="Title" />
235 | 代码
238 | 239 |在一般的段落文字中，你可以使用反引号 ` 来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 码：
I strongly recommend against using any `<blink>` tags.
242 |
243 | I wish SmartyPants used named entities like `—`
244 | instead of decimal-encoded entites like `—`.
245 | 输出 HTML 为：
248 | 249 |<p>I strongly recommend against using any
250 | <code><blink></code> tags.</p>
251 | <p>I wish SmartyPants used named entities like
252 | <code>&mdash;</code> instead of decimal-encoded
253 | entites like <code>&#8212;</code>.</p>
254 | 如果要建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 &、< 和 > 也一样会自动转成 HTML 实体。
Markdown 语法:
259 | 260 |If you want your page to validate under XHTML 1.0 Strict,
261 | you've got to put paragraph tags in your blockquotes:
262 |
263 | <blockquote>
264 | <p>For example.</p>
265 | </blockquote>
266 | 输出 HTML 为：
269 | 270 |<p>If you want your page to validate under XHTML 1.0 Strict,
271 | you've got to put paragraph tags in your blockquotes:</p>
272 | <pre><code><blockquote>
273 | <p>For example.</p>
274 | </blockquote>
275 | </code></pre>
276 | << 访问主页
2 | 3 |声明： 这份文档派生(fork)于繁体中文版，在此基础上进行了繁体转简体工作，并进行了适当的润色。此文档用 Markdown 语法编写，你可以到这里查看它的源文件。「繁体中文版的原始文件可以查看这里」--By @riku / 获取 Linode VPS
4 | 5 |注： 本项目托管于 GitHub上，请通过"派生"和"合并请求"来帮忙改进本项目。
6 | 7 |Markdown: Basics （快速入门） / (点击查看完整语法说明)
8 | 9 |Getting the Gist of Markdown's Formatting Syntax
10 | 11 |此页提供了 Markdown 的简单概念， 语法说明 页提供了完整详细的文档，说明了每项功能。但是 Markdown 其实很简单就可以上手，此页文档提供了一些范例，并且每个范例都会提供输出的 HTML 结果。
12 | 13 |其实直接试试看也是一个很不错的方法， Dingus 是一个网页应用程序，你可以把自已编写的 Markdown 文档转成 XHTML。
14 | 15 |段落、标题、区块代码
16 | 17 |一个段落是由一个以上的连接的行句组成，而一个以上的空行则会划分出不同的段落（空行的定义是显示上看起来像是空行，就被视为空行，例如有一行只有空白和 tab，那该行也会被视为空行），一般的段落不需要用空白或换行缩进。
18 | 19 |Markdown 支持两种标题的语法，Setext 和 atx 形式。Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），Atx 形式在行首插入 1 到 6 个 # ，对应到标题 1 到 6 阶。
区块引用则使用 email 形式的 '>' 角括号。
Markdown 语法:
24 | 25 |A First Level Header
26 | ====================
27 | A Second Level Header
28 | ---------------------
29 |
30 | Now is the time for all good men to come to
31 | the aid of their country. This is just a
32 | regular paragraph.
33 |
34 | The quick brown fox jumped over the lazy
35 | dog's back.
36 | ### Header 3
37 |
38 | > This is a blockquote.
39 | >
40 | > This is the second paragraph in the blockquote.
41 | >
42 | > ## This is an H2 in a blockquote
43 | 输出 HTML 为：
46 | 47 |<h1>A First Level Header</h1>
48 | <h2>A Second Level Header</h2>
49 | <p>Now is the time for all good men to come to
50 | the aid of their country. This is just a
51 | regular paragraph.</p>
52 | <p>The quick brown fox jumped over the lazy
53 | dog's back.</p>
54 | <h3>Header 3</h3>
55 | <blockquote>
56 | <p>This is a blockquote.</p>
57 | <p>This is the second paragraph in the blockquote.</p>
58 | <h2>This is an H2 in a blockquote</h2>
59 | </blockquote>
60 | 修辞和强调
63 | 64 |Markdown 使用星号和底线来标记需要强调的区段。
65 | 66 |Markdown 语法:
67 | 68 |Some of these words *are emphasized*.
69 | Some of these words _are emphasized also_.
70 | Use two asterisks for **strong emphasis**.
71 | Or, if you prefer, __use two underscores instead__.
72 | 输出 HTML 为:
75 | 76 |<p>Some of these words <em>are emphasized</em>.
77 | Some of these words <em>are emphasized also</em>.</p>
78 | <p>Use two asterisks for <strong>strong emphasis</strong>.
79 | Or, if you prefer, <strong>use two underscores instead</strong>.</p>
80 | 列表
83 | 84 |无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号：
85 | 86 |* Candy.
87 | * Gum.
88 | * Booze.
89 | 加号：
92 | 93 |+ Candy.
94 | + Gum.
95 | + Booze.
96 | 和减号
99 | 100 |- Candy.
101 | - Gum.
102 | - Booze.
103 | 都会输出 HTML 为：
106 | 107 |<ul>
108 | <li>Candy.</li>
109 | <li>Gum.</li>
110 | <li>Booze.</li>
111 | </ul>
112 | 有序的列表则是使用一般的数字接着一个英文句点作为项目标记：
115 | 116 |1. Red
117 | 2. Green
118 | 3. Blue
119 | 输出 HTML 为：
122 | 123 |<ol>
124 | <li>Red</li>
125 | <li>Green</li>
126 | <li>Blue</li>
127 | </ol>
128 | 如果你在项目之间插入空行，那项目的内容会用 <p> 包起来，你也可以在一个项目内放上多个段落，只要在它前面缩排 4 个空白或 1 个 tab 。
* A list item.
133 | With multiple paragraphs.
134 |
135 | * Another item in the list.
136 | 输出 HTML 为：
139 | 140 |<ul>
141 | <li><p>A list item.</p>
142 | <p>With multiple paragraphs.</p></li>
143 | <li><p>Another item in the list.</p></li>
144 | </ul>
145 | 链接
148 | 149 |Markdown 支援两种形式的链接语法： 行内 和 参考 两种形式，两种都是使用角括号来把文字转成连结。
150 | 151 |行内形式是直接在后面用括号直接接上链接：
152 | 153 |This is an [example link](http://example.com/).
154 | 输出 HTML 为：
157 | 158 |<p>This is an <a href="http://example.com/">
159 | example link</a>.</p>
160 | 你也可以选择性的加上 title 属性：
163 | 164 |This is an [example link](http://example.com/ "With a Title").
165 | 输出 HTML 为：
168 | 169 |<p>This is an <a href="http://example.com/" title="With a Title">
170 | example link</a>.</p>
171 | 参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容：
174 | 175 |I get 10 times more traffic from [Google][1] than from
176 | [Yahoo][2] or [MSN][3].
177 |
178 | [1]: http://google.com/ "Google"
179 | [2]: http://search.yahoo.com/ "Yahoo Search"
180 | [3]: http://search.msn.com/ "MSN Search"
181 | 输出 HTML 为：
184 | 185 |<p>I get 10 times more traffic from <a href="http://google.com/"
186 | title="Google">Google</a> than from <a href="http://search.yahoo.com/"
187 | title="Yahoo Search">Yahoo</a> or <a href="http://search.msn.com/"
188 | title="MSN Search">MSN</a>.</p>
189 | title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写：
192 | 193 |I start my morning with a cup of coffee and
194 | [The New York Times][NY Times].
195 |
196 | [ny times]: http://www.nytimes.com/
197 | 输出 HTML 为：
200 | 201 |<p>I start my morning with a cup of coffee and
202 | <a href="http://www.nytimes.com/">The New York Times</a>.</p>
203 | 图片
206 | 207 |图片的语法和链接很像。
208 | 209 |行内形式（title 是选择性的）：
210 | 211 |
212 | 参考形式：
215 | 216 |![alt text][id]
217 |
218 | [id]: /path/to/img.jpg "Title"
219 | 上面两种方法都会输出 HTML 为：
222 | 223 |<img src="/path/to/img.jpg" alt="alt text" title="Title" />
224 | 代码
227 | 228 |在一般的段落文字中，你可以使用反引号 ` 来标记代码区段，区段内的 &、< 和 > 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 码：
I strongly recommend against using any `<blink>` tags.
231 |
232 | I wish SmartyPants used named entities like `—`
233 | instead of decimal-encoded entites like `—`.
234 | 输出 HTML 为：
237 | 238 |<p>I strongly recommend against using any
239 | <code><blink></code> tags.</p>
240 | <p>I wish SmartyPants used named entities like
241 | <code>&mdash;</code> instead of decimal-encoded
242 | entites like <code>&#8212;</code>.</p>
243 | 如果要建立一个已经格式化好的代码区块，只要每行都缩进 4 个空格或是一个 tab 就可以了，而 &、< 和 > 也一样会自动转成 HTML 实体。
Markdown 语法:
248 | 249 |If you want your page to validate under XHTML 1.0 Strict,
250 | you've got to put paragraph tags in your blockquotes:
251 |
252 | <blockquote>
253 | <p>For example.</p>
254 | </blockquote>
255 | 输出 HTML 为：
258 | 259 |<p>If you want your page to validate under XHTML 1.0 Strict,
260 | you've got to put paragraph tags in your blockquotes:</p>
261 | <pre><code><blockquote>
262 | <p>For example.</p>
263 | </blockquote>
264 | </code></pre>
265 | A First Level Header
60 |A Second Level Header
61 |Now is the time for all good men to come to 62 | the aid of their country. This is just a 63 | regular paragraph.
64 |The quick brown fox jumped over the lazy 65 | dog's back.
66 |Header 3
67 |68 |72 | 73 | ### 修辞和强调 ### 74 | 75 | Markdown 使用星号和底线来标记需要强调的区段。 76 | 77 | Markdown 语法: 78 | 79 | Some of these words *are emphasized*. 80 | Some of these words _are emphasized also_. 81 | Use two asterisks for **strong emphasis**. 82 | Or, if you prefer, __use two underscores instead__. 83 | 84 | 输出 HTML 为: 85 | 86 |This is a blockquote.
69 |This is the second paragraph in the blockquote.
70 |This is an H2 in a blockquote
71 |
Some of these words are emphasized. 87 | Some of these words are emphasized also.
88 |Use two asterisks for strong emphasis. 89 | Or, if you prefer, use two underscores instead.
90 | 91 | ## 列表 ## 92 | 93 | 无序列表使用星号、加号和减号来做为列表的项目标记，这些符号是都可以使用的，使用星号： 94 | 95 | * Candy. 96 | * Gum. 97 | * Booze. 98 | 99 | 加号： 100 | 101 | + Candy. 102 | + Gum. 103 | + Booze. 104 | 105 | 和减号 106 | 107 | - Candy. 108 | - Gum. 109 | - Booze. 110 | 111 | 都会输出 HTML 为： 112 | 113 |-
114 |
- Candy. 115 |
- Gum. 116 |
- Booze. 117 |
-
128 |
- Red 129 |
- Green 130 |
- Blue 131 |
` 包起来，你也可以在一个项目内放上多个段落，只要在它前面缩排 4 个空白或 1 个 tab 。 134 | 135 | * A list item. 136 | With multiple paragraphs. 137 | 138 | * Another item in the list. 139 | 140 | 输出 HTML 为： 141 | 142 |
-
143 |
A list item.
144 |With multiple paragraphs.
145 | Another item in the list.
146 |
This is an 158 | example link.
159 | 160 | 你也可以选择性的加上 title 属性： 161 | 162 | This is an [example link](http://example.com/ "With a Title"). 163 | 164 | 输出 HTML 为： 165 | 166 |This is an 167 | example link.
168 | 169 | 参考形式的链接让你可以为链接定一个名称，之后你可以在文件的其他地方定义该链接的内容： 170 | 171 | I get 10 times more traffic from [Google][1] than from 172 | [Yahoo][2] or [MSN][3]. 173 | 174 | [1]: http://google.com/ "Google" 175 | [2]: http://search.yahoo.com/ "Yahoo Search" 176 | [3]: http://search.msn.com/ "MSN Search" 177 | 178 | 输出 HTML 为： 179 | 180 |I get 10 times more traffic from Google than from Yahoo or MSN.
184 | 185 | title 属性是选择性的，链接名称可以用字母、数字和空格，但是不分大小写： 186 | 187 | I start my morning with a cup of coffee and 188 | [The New York Times][NY Times]. 189 | 190 | [ny times]: http://www.nytimes.com/ 191 | 192 | 输出 HTML 为： 193 | 194 |I start my morning with a cup of coffee and 195 | The New York Times.
196 | 197 | 198 | ### 图片 ### 199 | 200 | 图片的语法和链接很像。 201 | 202 | 行内形式（title 是选择性的）： 203 | 204 |  205 | 206 | 参考形式： 207 | 208 | ![alt text][id] 209 | 210 | [id]: /path/to/img.jpg "Title" 211 | 212 | 上面两种方法都会输出 HTML 为： 213 | 214 |
215 |
216 | ### 代码 ###
217 | 在一般的段落文字中，你可以使用反引号 `` ` `` 来标记代码区段，区段内的 `&`、`<` 和 `>` 都会被自动的转换成 HTML 实体，这项特性让你可以很容易的在代码区段内插入 HTML 码：
218 |
219 | I strongly recommend against using any `