Markdown文法

1.2 Markdown的優點：

1.專注你的文字内容而不是排版樣式

2.輕松的導出HTML、PDF和本身的.md檔案

3.純文字内容，相容所有的文本編輯器與字處理軟體

4.可讀，直覺。适合所有人的寫作語言

1.3 Markdown相容HTML

HTML是一種釋出的格式，Markdown是一種書寫的格式。Markdown的格式文法隻涵蓋純文字可以涵蓋的範圍，不在Markdown涵蓋範圍之内的标簽，都可以直接在文檔裡面用HTML撰寫。不需要額外标注這是HTML或是Markdown;隻要直接加标簽就可以了。

要制約的隻有一些HTML區塊元素——比如

、

、      

等标簽，必須在前後加上空行與其他内容區隔開，還要求它們的标簽與結尾标簽不能用制表符或空格來縮進。Markdown的生成器有足夠智能，不會在HTML區塊标簽外加上不必要的

标簽。

在HTML 區 塊 \color{red}{區塊}區塊标簽間的Markdown格式文法将不會被處理，在HTML區 段 \color{red}{區段}區段标簽間Markdown文法是生效的。

1. Markdown的文法

2.1 Markdown的自動符号的轉換文法

HTML：有兩個字元需要特殊處理：< 和 & 。< 符号用于起始标簽，& 符号則用于标記HTML實體，如果你隻是想要顯示這些字元的原型，則必須使用實體的形式。（類似于轉義字元）例如<:&It;和&:&另外© 可以寫成©也可以直接輸 ©

Markdown: 這三個字元自動轉換，不需要人為轉義。如果你使用的&字元是HTML字元實體的一部分，它會保留原狀，否則它會被轉換成& 。比如：你想要顯示

AT&T

1

那麼在Markdown中寫成

AT&T ：這是Markdown的寫法

AT&T ：這是HTML的正确寫法，但是在Markdown中也會被自動轉換

2

都能達到想要實作的效果。

2.2 Markdown區塊元素：段落換行和縮進

一個 Markdown 段落的前後要有一個以上的空行。普通段落不該用空格或制表符來縮進。如果想在段前加縮進

 是一個中文字元  是半個中文字元  是1/4中文字元

普通段落也不能用回車來換行（當然如果你使用的是typora的話，可以直接回車建立新段落）

1.使用

内容

來組成封閉的一行

2.使用<br/>換行

• 當然這會對插入<br/>标簽造成麻煩。如果你确實想要依賴Markdown來插入<br/>标簽的話，在插入處先按入兩個以上的空格然後回車。

3

2.3 Markdown标題

Markdown支援兩種标題的文法，類Setext和類atx形式

類Setext形式是用底線的形式，利用 = （最高階标題）和 - （第二階标題），緊挨着顯示的标題下一行輸入，例如：

第一階标題

第二階标題顯示效果有下劃線

（任意數量的=和-都可以有效果）

類Atx形式則是在行首插入1到6個#，對應到标題1到6階，例如：

2.4 Markdown标記區塊引用(常用于備注說明)

Markdown 标記區塊引用是使用類似 email 中用 > 的引用方式。 在每行的最前面加上 >

區塊引用可以嵌套（例如：引用内的引用），隻要根據層次加上不同數量的 > ,例如：

引用

嵌套引用

效果如下：

引用的區塊内也可以使用其他的 Markdown 文法，包括标題、清單、代碼區塊等：

這是一個标題。

1. FirstLine。
2. SecondLine。

給出一些例子代碼：

return shell_exec("echo $input | $markdown_script");           

4

5

6

7

8

效果如下:

return shell_exec("echo $input | $markdown_script");

Markdown也允許你偷懶隻在整個段落的第一行最前面加上> :