Markdown學(xué)習(xí)文檔

概述

宗旨

Markdown 的目標(biāo)是實(shí)現(xiàn)「易讀易寫」

易讀：一份使用 Markdown 格式撰寫的文件應(yīng)該可以直接以純文本發(fā)布，并且看起來不會(huì)像是由許多標(biāo)簽或是格式指令所構(gòu)成。

易寫： Markdown 的語法全由一些符號所組成，這些符號經(jīng)過精挑細(xì)選，其作用一目了然

常用編輯器

  • 在線的編輯器:
    1.dillinger 漂亮強(qiáng)大，支持md, html, pdf 文件導(dǎo)出。支持dropbox, onedrive，google drive, github. 來自國外，可能不夠穩(wěn)定。

    image

    2.MaHua 小眾軟件推薦，界面有些簡陋。
    image

    3.簡書 一個(gè)很不錯(cuò)的博客平臺(tái)，每幾秒鐘便會(huì)自動(dòng)存入一個(gè)備份。可以直接從本地拖入照片生成鏈接，一直在不斷優(yōu)化。作為一個(gè)博客平臺(tái)，需要注冊賬號后方能進(jìn)行寫作。
    image

  • 支持多平臺(tái):
    1.FarBox 一個(gè)支持Markdown寫作語法的博客平臺(tái)，讓用戶通過Dropbox（現(xiàn)在默認(rèn)是自己的同步服務(wù)器）直接建立個(gè)人網(wǎng)站。FarBox編輯器免費(fèi)，支持多平臺(tái)（無web版，Linux版停止維護(hù)），個(gè)人認(rèn)為是Windows平臺(tái)最優(yōu)雅的編輯器。多說一句，F(xiàn)arbox服務(wù)可以免費(fèi)試用，在本地編輯器內(nèi)寫作自動(dòng)同步發(fā)布在個(gè)人博客

    image

    2.Cmd Markdown 作業(yè)部落出品，也是一款不錯(cuò)的工具和博客平臺(tái)兼顧的產(chǎn)品。全平臺(tái)且提供web版
    image

    3.有道云筆記 我比較喜歡用的，它比較方便，支持多種格式文件上傳，下載，且免費(fèi)
    image

  • Windows平臺(tái)編輯器
    1.MarkdownPad 一款全功能的編輯器，被很多人稱贊為windows 平臺(tái)最好用的markdown編輯器

    image

    2.Smark 開源軟件
    image

  • OS X平臺(tái)
    1.Mou 似乎提到 Mac 和 MD ,接下來的詞一定是Mou

    image

    2.MacDown 開源免費(fèi)
    image

兼容 HTML

Markdown 語法的目標(biāo)是：成為一種適用于網(wǎng)絡(luò)的書寫語言

Markdown 不是想要取代HTML，也沒有要和它相近，它的語法種類很少，只對應(yīng)HTML 標(biāo)記的一小部分。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。
HTML 是一種++發(fā)布++的格式，Markdown 是一種++書寫++的格式。

特殊字符自動(dòng)轉(zhuǎn)換

在 HTML 文件中，有兩個(gè)字符需要特殊處理： < 和 & 。 < 符號用于起始標(biāo)簽，& 符號則用于標(biāo)記 HTML 實(shí)體，如果你只是想要顯示這些字符的原型，你必須要使用實(shí)體的形式，像是 < 和 &。

Markdown 讓你可以自然地書寫字符，需要轉(zhuǎn)換的由它來處理好了。如果你使用的 & 字符是 HTML 字符實(shí)體的一部分，它會(huì)保留原狀，否則它會(huì)被轉(zhuǎn)換成 &。

所以你如果要在文檔中插入一個(gè)版權(quán)符號 ?，你可以這樣寫：? Markdown會(huì)保留它不動(dòng)。
而若你寫：AT&T
Markdown 就會(huì)將它轉(zhuǎn)為：AT&T

反斜杠

Markdown 可以利用反斜杠來插入一些在語法中有其它意義的符號，例如：如果你想要用星號加在文字旁邊的方式來做出強(qiáng)調(diào)效果（但不用 <em> 標(biāo)簽），你可以在星號的前面加上反斜杠：
Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號：
\ 反斜杠
` 反引號
* 星號
_ 下劃線
{} 大括號
[] 中括號
() 小括號
# 井號
+ 加號
- 減號
. 英文句號
! 感嘆號

段落和換行

一個(gè) Markdown 段落是由一個(gè)或多個(gè)連續(xù)的文本行組成，它的前后要有一個(gè)以上的空行（空行的定義是顯示上看起來像是空的，便會(huì)被視為空行。比方說，若某一行只包含空格和制表符，則該行也會(huì)被視為空行）。普通段落不該用空格或制表符來縮進(jìn)。

如果你確實(shí)想要依賴 Markdown來插入
標(biāo)簽的話，在插入處先按入兩個(gè)以上的空格然后回車。

段首空格

沒有空格
? 半角空格（英文)
? 全角空格（中文）
? 另一種空格

標(biāo)題

Markdown 支持兩種標(biāo)題的語法，類 Setext 和類 atx 形式。

類 Setext 形式是用底線的形式，利用 =（最高階標(biāo)題）和 -（第二階標(biāo)題），例如：

This is an H1

This is an H2

任何數(shù)量的 = 和 - 都可以有效果。

類 Atx 形式則是在行首插入 1 到 6 個(gè) # ，對應(yīng)到標(biāo)題 1 到 6 階，例如：

這是 H1

這是 H2

....

這是 H6

你可以選擇性地「閉合」類 atx 樣式的標(biāo)題，這純粹只是美觀用的，若是覺得這樣看起來比較舒適，你就可以在行尾加上 #，而行尾的 # 數(shù)量也不用和開頭一樣（行首的井字符數(shù)量決定標(biāo)題的階數(shù)）：

這是 H1

這是 H2

這是 H3

列表

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

無序列表使用星號、加號或是減號作為列表標(biāo)記：

  • Red
  • Green
  • Blue

等同于：

  • Red
  • Green
  • Blue

也等同于:

  • Red
  • Green
  • Blue

有序列表則使用數(shù)字接著一個(gè)英文句點(diǎn)：

  1. Tom
  2. Bob
  3. Jack

很重要的一點(diǎn)是，你在列表標(biāo)記上使用的數(shù)字并不會(huì)影響輸出的 HTML 結(jié)果，上面的列表所產(chǎn)生的 HTML 標(biāo)記為：

<ol>
<li>Bird</li>
? ? <li>McHale</li>
? ? <li>Parish</li>
</ol>

如果你的列表標(biāo)記寫成：

  1. Bird
  2. McHale
  3. Parish

或甚至是：

  1. Bird
  2. McHale
  3. Parish

你都會(huì)得到完全相同的 HTML 輸出。重點(diǎn)在于，你可以讓 Markdown 文件的列表數(shù)字和輸出的結(jié)果相同，或是你懶一點(diǎn)，你可以完全不用在意數(shù)字的正確性。
如果你使用懶惰的寫法，建議第一個(gè)項(xiàng)目最好還是從 1. 開始，因?yàn)?Markdown 未來可能會(huì)支持有序列表的 start 屬性。

列表項(xiàng)目標(biāo)記通常是放在最左邊，但是其實(shí)也可以縮進(jìn)，最多3個(gè)空格，項(xiàng)目標(biāo)記后面則一定要接著至少一個(gè)空格或制表符。

要讓列表看起來更漂亮，你可以把內(nèi)容用固定的縮進(jìn)整理好：

  • 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.

分割線

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

鏈接

Markdown 支持兩種形式的鏈接語法： 行內(nèi)式和參考式兩種形式。

不管是哪一種，鏈接文字都是用 [方括號] 來標(biāo)記。

要建立一個(gè)行內(nèi)式的鏈接，只要在方塊括號后面緊接著圓括號并插入網(wǎng)址鏈接即可，如果你還想要加上鏈接的 title 文字，只要在網(wǎng)址后面，用雙引號把 title 文字包起來即可，例如：
This is an example inline link. This link has no title attribute.

如果你是要鏈接到同樣主機(jī)的資源，你可以使用相對路徑：

See my About page for details.

參考式的鏈接是在鏈接文字的括號后面再接上另一個(gè)方括號，而在第二個(gè)方括號里面要填入用以辨識(shí)鏈接的標(biāo)記：

This is an example reference-style link.

你也可以選擇性地在兩個(gè)方括號中間加上一個(gè)空格：

This is an example reference-style link.

接著，在文件的任意處，你可以把這個(gè)標(biāo)記的鏈接內(nèi)容定義出來：

強(qiáng)調(diào)

Markdown 使用星號（*）和底線（_）作為標(biāo)記強(qiáng)調(diào)字詞的符號，被 * 或 _ 包圍的字詞會(huì)被轉(zhuǎn)成用 <em> 標(biāo)簽包圍，用兩個(gè) * 或 _ 包起來的話，則會(huì)被轉(zhuǎn)成 <strong>，例如：
single asterisks
single underscores
double asterisks
double underscores
會(huì)轉(zhuǎn)成：

<em>single asterisks</em>

<em>single underscores</em>

<strong>double asterisks</strong>

<strong>double underscores</strong>

你可以隨便用你喜歡的樣式，唯一的限制是，你用什么符號開啟標(biāo)簽，就要用什么符號結(jié)束。

強(qiáng)調(diào)也可以直接插在文字中間：

unfriggingbelievable

但是如果你的 * 和 _ 兩邊都有空白的話，它們就只會(huì)被當(dāng)成普通的符號。

如果要在文字前后直接插入普通的星號或底線，你可以用反斜線：

*this text is surrounded by literal asterisks*

圖片

很明顯地，要在純文字應(yīng)用中設(shè)計(jì)一個(gè)「自然」的語法來插入圖片是有一定難度的

Markdown 使用一種和鏈接很相似的語法來標(biāo)記圖片，同樣也允許兩種樣式： 行內(nèi)式和參考式。

[圖片上傳失敗...(image-d893df-1512716941464)]

image

詳細(xì)敘述如下：

  • 一個(gè)驚嘆號 !
  • 接著一個(gè)方括號，里面放上圖片的替代文字
  • 接著一個(gè)普通括號，里面放上圖片的網(wǎng)址，最后還可以用引號包住并加上 選擇性的 'title' 文字。

參考式的圖片語法則長得像這樣：
「id」是圖片參考的名稱，圖片參考的定義方式則和鏈接參考一樣：

Alt text
Alt text

**
Alt text
Alt text

圖片上傳失敗...(image-180e8c-1512716941464)
到目前為止， Markdown還沒有辦法指定圖片的寬高，如果你需要的話，你可以使用普通的 <img> 標(biāo)簽。

優(yōu)點(diǎn)：代碼語法簡單、專注于撰寫內(nèi)容、排版清晰簡潔

中劃線

學(xué)習(xí)網(wǎng)站：http://wowubuntu.com/markdown/#list

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

友情鏈接更多精彩內(nèi)容