Markdown語法

標題語法

H1

H2

H3

H4

H5
H6

區塊引用 Blockquotes

這里是一個區塊
blockquotes

區塊跳行 ...
class HelloWorld {
public static void main (String[] args){
System.out.println("");
}
} //只要再最后一行加上‘>’也行

引用的嵌套

這是一個標題。

  1. 這是第一行列表項。
  1. 這是第二行列表項。

給出一些例子代碼:
return shell_exec("echo $input | $markdown_script");

列表

Markdown 支持有序列表和無序列表。

無序列表使用星號、加號或是減號作為列表標記:
  • Red
  • Green
  • Blue

等同于:

  • Red
  • Green
  • Blue

也等同于:

  • Red
  • Green
  • Blue

有序列表則使用數字接著一個英文句點:

  1. Bird
  2. McHale
  3. Parish

列表項目標記通常是放在最左邊,但是其實也可以縮進,最多 3 個空格,項目標記后面則一定要接著至少一個空格或制表符。
要讓列表看起來更漂亮,你可以把內容用固定的縮進整理好:

  • Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
  • Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse id sem consectetuer libero luctus adipiscing.

如果要在列表項目內放進引用,那 >
就需要縮進:

  • A list item with a blockquote: > This is a blockquote > inside a list item.

如果要放代碼區塊的話,該區塊就需要縮進兩次,也就是 8 個空格或是 2 個制表符:

  • 一列表項包含一個列表區塊: <代碼寫在這>

當然,項目列表很可能會不小心產生,像是下面這樣的寫法:

  1. What a great season.

換句話說,也就是在行首出現數字-句點-空白,要避免這樣的狀況,你可以在句點前面加上反斜杠。
1986. What a great season.

代碼區塊

<pre><code>NSLog("%@",NSString stringWithFormat:@"HelloWorld")</code></pre>

分割線

你可以在一行中用三個以上的星號、減號、底線來建立一個分隔線,行內不能有其他東西。你也可以在星號或是減號中間插入空格。下面每種寫法都可以建立分隔線:






區段元素

鏈接

Markdown 支持兩種形式的鏈接語法: 行內式參考式 兩種形式。
不管是哪一種,鏈接文字都是用 [方括號] 來標記。
要建立一個行內式的鏈接,只要在方塊括號后面緊接著圓括號并插入網址鏈接即可,如果你還想要加上鏈接的 title 文字,只要在網址后面,用雙引號把 title 文字包起來即可,例如:
<blockquote>
This is an example inline link.This link has no title attribute.
</blockquote>
會產生:
<blockquote>
<p>This is <a title="Title">
an example</a> inline link.</p>

<p><a >This link</a> has no
title attribute.</p>
</blockquote>

如果你是要鏈接到同樣主機的資源,你可以使用相對路徑:
<blockquote>
See my About page for details.
</blockquote>
參考式的鏈接是在鏈接文字的括號后面再接上另一個方括號,而在第二個方括號里面要填入用以辨識鏈接的標記:
<blockquote>
This is [an example][id] reference-style link.
</blockquote>
你也可以選擇性地在兩個方括號中間加上一個空格:
<blockquote>
This is [an example] [id] reference-style link.
</blockquote>
接著,在文件的任意處,你可以把這個標記的鏈接內容定義出來:
<blockquote>
[id]: http://example.com/ "Optional Title Here"
</blockquote>

強調

Markdown 使用星號()和底線()作為標記強調字詞的符號,被 *或 _ 包圍的字詞會被轉成用 <em>標簽包圍,用兩個 *或包起來的話,則會被轉成 <strong>,例如:
single asteriskssingle underscores
double asterisks*double underscores

會轉成:
<em>single asterisks</em><em>single underscores</em><strong>double asterisks</strong><strong>double underscores</strong>

你可以隨便用你喜歡的樣式,唯一的限制是,你用什么符號開啟標簽,就要用什么符號結束。
強調也可以直接插在文字中間:
unfriggingbelievable

但是*如果你的 和 _兩邊都有空白的話,它們就只會被當成普通的符號。
如果要在文字前后直接插入普通的星號或底線,你可以用反斜線:
*this text is surrounded by literal asterisks*

代碼

如果要標記一小段行內代碼,你可以用反引號把它包起來(`),例如:

Use the printf() function.

圖片

很明顯地,要在純文字應用中設計一個「自然」的語法來插入圖片是有一定難度的。
Markdown 使用一種和鏈接很相似的語法來標記圖片,同樣也允許兩種樣式: 行內式參考式。
行內式的圖片語法看起來像是:

Alt text
Alt text
Alt text
Alt text

詳細敘述如下:
一個驚嘆號 !

接著一個方括號,里面放上圖片的替代文字
接著一個普通括號,里面放上圖片的網址,最后還可以用引號包住并加上 選擇性的 'title' 文字。

參考式的圖片語法則長得像這樣:
![Alt text][id]

「id」是圖片參考的名稱,圖片參考的定義方式則和連結參考一樣:
[id]: url/to/image "Optional title attribute"

到目前為止, Markdown 還沒有辦法指定圖片的寬高,如果你需要的話,你可以使用普通的 <img>
標簽。

如果實在看暈了 : 看一下wiki上的這個對比圖就知道了

(https://en.wikipedia.org/wiki/Markdown#Example)


給個github follow me的鏈接,上面有很多初學者可供學習的資料,項目.

<a>https://github.com/SuperZee</a>

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容