Markdown: Basics
================
Getting the Gist of Markdown's Formatting Syntax
------------------------------------------------
This page offers a brief overview of what it's like to use Markdown.
The [syntax page] [s] provides complete, detailed documentation for
every feature, but Markdown should be very easy to pick up simply by
looking at a few examples of it in action. The examples on this page
are written in a before/after style, showing example syntax and the
HTML output produced by Markdown.
這頁提供了 Markdown 簡單的概觀給想使用的人， [語法說明][s] 頁提供了
完整詳細的文件，說明每項功能，但是 Markdown 其實很簡單就可以上手，
這頁文件提供了一些範例，並且每個範例都有提供輸出的 HTML 結果。
It's also helpful to simply try Markdown out; the [Dingus] [d] is a
web application that allows you type your own Markdown-formatted text
and translate it to XHTML.
其實直接試試看也是一個很不錯的方法， [Dingus][d] 是一個網頁應用程式，
讓你可以把你的 Markdown 文件轉成 XHTML。
**Note:** This document is itself written using Markdown; you
can [see the source for it by adding '.text' to the URL] [src].
**Note:** 這份文件本身也是用 Markdown 寫的，你也可以看看 [它的原始碼][src]
[s]: http://markdown.tw "Markdown Syntax"
[d]: http://daringfireball.net/projects/markdown/dingus "Markdown Dingus"
[src]: https://github.com/othree/markdown-syntax-zhtw/blob/master/basics.md
## Paragraphs, Headers, Blockquotes ##
A paragraph is simply one or more consecutive lines of text, separated
by one or more blank lines. (A blank line is any line that looks like
a blank line -- a line containing nothing but spaces or tabs is
considered blank.) Normal paragraphs should not be indented with
spaces or tabs.
一個段落是由一個以上的連接的行句組成，而一個以上的空行則會切分出不同的段落
（空行的定義是顯示上看起來像是空行，就被視為空行，例如有一行只有空白和 tab，
那該行也會被視為空行），一般的段落不需要用空白或斷行縮排。
Markdown offers two styles of headers: *Setext* and *atx*.
Setext-style headers for `` and `` are created by
"underlining" with equal signs (`=`) and hyphens (`-`), respectively.
To create an atx-style header, you put 1-6 hash marks (`#`) at the
beginning of the line -- the number of hashes equals the resulting
HTML header level.
Markdown 支援兩種標題的語法，[Setext] [1] 和 [atx] [2] 形式。
Setext 形式是用底線的形式，利用 `=` （最高階標題）和 `-` （第二階標題），
Atx 形式在行首插入 1 到 6 個 `#` ，對應到標題 1 到 6 階。
Blockquotes are indicated using email-style '`>`' angle brackets.
區塊引言則使用 email 形式的 '`>`' 角括號。
Markdown:
A First Level Header
====================
A Second Level Header
---------------------
Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.
The quick brown fox jumped over the lazy
dog's back.
### Header 3
> This is a blockquote.
>
> This is the second paragraph in the blockquote.
>
> ## This is an H2 in a blockquote
Output:
輸出：
A First Level Header
A Second Level Header
Now is the time for all good men to come to
the aid of their country. This is just a
regular paragraph.
The quick brown fox jumped over the lazy
dog's back.
Header 3
This is a blockquote.
This is the second paragraph in the blockquote.
This is an H2 in a blockquote
### Phrase Emphasis ###
Markdown uses asterisks and underscores to indicate spans of emphasis.
Markdown 使用星號和底線來標記需要強調的區段。
Markdown:
Some of these words *are emphasized*.
Some of these words _are emphasized also_.
Use two asterisks for **strong emphasis**.
Or, if you prefer, __use two underscores instead__.
Output:
Some of these words are emphasized.
Some of these words are emphasized also.
Use two asterisks for strong emphasis.
Or, if you prefer, use two underscores instead.
## Lists ##
Unordered (bulleted) lists use asterisks, pluses, and hyphens (`*`,
`+`, and `-`) as list markers. These three markers are
interchangable; this:
無序清單使用星號、加號和減號來做為清單的項目標記，這些符號是都可以使用的，
使用星號：
* Candy.
* Gum.
* Booze.
this:
加號：
+ Candy.
+ Gum.
+ Booze.
and this:
和減號
- Candy.
- Gum.
- Booze.
all produce the same output:
都會輸出：
Ordered (numbered) lists use regular numbers, followed by periods, as
list markers:
有序的清單則是使用一般的數字接著一個英文句點作為項目標記：
1. Red
2. Green
3. Blue
Output:
- Red
- Green
- Blue
If you put blank lines between items, you'll get `` tags for the
list item text. You can create multi-paragraph list items by indenting
the paragraphs by 4 spaces or 1 tab:
如果你在項目之間插入空行，那項目的內容會備用 `
` 包起來，你也可以在一個項目
內放上多個段落，只要在它前面縮排 4 個空白或 1 個 tab 。
* A list item.
With multiple paragraphs.
* Another item in the list.
Output:
### Links ###
Markdown supports two styles for creating links: *inline* and
*reference*. With both styles, you use square brackets to delimit the
text you want to turn into a link.
Inline-style links use parentheses immediately after the link text.
For example:
This is an [example link](http://example.com/).
Output:
This is an
example link.
Optionally, you may include a title attribute in the parentheses:
This is an [example link](http://example.com/ "With a Title").
Output:
This is an
example link.
Reference-style links allow you to refer to your links by names, which
you define elsewhere in your document:
I get 10 times more traffic from [Google][1] than from
[Yahoo][2] or [MSN][3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
Output:
I get 10 times more traffic from Google than from Yahoo or MSN.
The title attribute is optional. Link names may contain letters,
numbers and spaces, but are *not* case sensitive:
I start my morning with a cup of coffee and
[The New York Times][NY Times].
[ny times]: http://www.nytimes.com/
Output:
I start my morning with a cup of coffee and
The New York Times.
### Images ###
Image syntax is very much like link syntax.
Inline (titles are optional):
Reference-style:
![alt text][id]
[id]: /path/to/img.jpg "Title"
Both of the above examples produce the same output:
### Code ###
In a regular paragraph, you can create code span by wrapping text in
backtick quotes. Any ampersands (`&`) and angle brackets (`<` or
`>`) will automatically be translated into HTML entities. This makes
it easy to use Markdown to write about HTML example code:
I strongly recommend against using any `