書寫格式 (Markdown)

Q. 為何使用 Markdown 撰寫文件?
A. 只需記住幾種格式化標記語法,就可以用鍵盤完成大部份內容,不必動滑鼠及設定網頁文字格式。此結構化/半結構化文件容易被轉換成其它種類格式,例如 Dokuwiki / LaTex 等,未來可以方便輸出成發行出版的格式。

即使不經過畫面輸出處理 (rendered) ,採用 Markdown 標記的文件仍具有一定的可讀性 (readable) 。

將 Markdown 文字複製貼到 NotePaq 即可預覽處理後的結果。

* DEMO 1: http://notepag.es/uF4mrf (請愛用 Mac OS X 瀏覽,在 Windows 下字型不堪入目阿!!!!)

未來計畫在文件右上方提供「高品質閱讀」按鈕,輸出成方便閱讀的 HTML / PDF 格式,並以 iPad 可以看得舒服為目標。

但是!但是!因為沒有人敢說這種格式就比較好,而且提議人 (lyhcode) 也不清楚這會帶來什麼災難。但至少先採取一種比較乾淨的文字結構,以後要轉換還有機會...自動化。不然就哭哭了...


建立標題

# 大標題 #
## 標題2 ##
### 標題3 3 ###
#### 標題 4 ####
##### 標題 5 #####

標題連結

## 本標題位置可被連結 ##         {#title1}
[連結到標題](#title1)



This is a paragraph, which is text surrounded by whitespace. Paragraphs can be on one 
line (or many), and can drone on for hours.  

Here is a Markdown link to [Warped](http://warpedvisions.org), and a literal . 
Now some SimpleLinks, like one to [google] (automagically links to are-you-
feeling-lucky), a [wiki: test] link to a Wikipedia page, and a link to 
[foldoc: CPU]s at foldoc.  

Now some inline markup like _italics_,  **bold**, and `code()`. Note that underscores in 
words are ignored in Markdown Extra.

![picture alt](/images/photo.jpeg "Title is optional")     

> Blockquotes are like quoted text in email replies
>> And, they can be nested

* Bullet lists are easy too
- Another one
+ Another one

1. A numbered list
2. Which is numbered
3. With periods and a space

And now some code:

    // Code is just text indented a bit
    which(is_easy) to_remember();

~~~

// Markdown extra adds un-indented code blocks too

if (this_is_more_code == true && !indented) {
    // tild wrapped code blocks, also not indented
}

~~~

Text with  
two trailing spaces  
(on the right)  
can be used  
for things like poems  

### Horizontal rules

* * * *
****
--------------------------


<div class="custom-class" markdown="1">
This is a div wrapping some Markdown plus.  Without the DIV attribute, it ignores the 
block. 
</div>

## Markdown plus tables ##

| Header | Header | Right  |
| ------ | ------ | -----: |
|  Cell  |  Cell  |   $10  |
|  Cell  |  Cell  |   $20  |

* Outer pipes on tables are optional
* Colon used for alignment (right versus left)

## Markdown plus definition lists ##

Bottled water
: $ 1.25
: $ 1.55 (Large)

Milk
Pop
: $ 1.75

* Multiple definitions and terms are possible
* Definitions can include multiple paragraphs too

*[ABBR]: Markdown plus abbreviations (produces an <abbr> tag)

Comments