Markdown指南

Markdown 指南

前幾天學習了markdown，而後一直在用，很喜歡這種格式即內容的寫做形式。在簡書寫了幾篇，對固定連接的格式很不滿意，因而尋找可以支持markdown、固定連接顯格式、支持自定義域名的博客平臺。Github是個很好的選擇，在折騰完Jekyll和Octopress幾近筋疲力盡的時候，一束光芒照過來，我看到了hexo。
說遠了…這篇文章是想介紹一下markdown這種寫做形式。

本質上，相似於html，markdown也是一種標記型語言，ie，用某些字符（不像html用字符串）標示某種格式，只是標記格式不一樣罷了。
好比：###Hello Word，標示出helloword是三級標題，markdown進行渲染後就成了對應大小、加粗的格式。
介紹markdown的教程太多了，我不打算作無用的重複，給出我認爲必讀的幾個供你們參考。

1. 魯塔弗：markdown 簡明語法
2. 圖靈社區：怎樣使用Markdown
3. 簡書：獻給寫做者的 Markdown 新手指南
4. 官方文檔(中文版)：Markdown 語法說明
5. 用Markdown來書寫你的博客

說明一下，上述1-3是並列關係，不一樣人總結的教程，建議都看。4比較繁瑣，能夠暫時不看，之後須要時再查詢便可。
還有，markdown就這麼點東西，學會了就一勞永逸了，性價比很高！

下面給出幾個編輯器，你們邊學邊練。

• 簡書 用微博登陸，開始記筆記吧！
• MaDe (Chrome插件)
• dillinger
• StackEdit 由TangPro推薦。
• Cmd - 在線 Markdown 編輯閱讀器

好了，開始你的markdown之旅吧！

markdown 番外篇

開博後寫過一篇Introduction to markdown，給出了幾個介紹markdown的教程。這幾個教程或是簡明易懂，或是全面規範，能夠做爲很好的入門教材或查閱手冊。

在實際的使用當中，我發現有些用法不是這些教程裏可以找到的，或者教程裏沒有進行應有的強調致使使用時容易出錯。本文就對這樣的問題進行彙總，並會不按期更新。

1. 刪除線。

   方法：在要劃刪除線的文本先後添加~~

   示例：~~看《冰與火之歌》~~

   解析爲： 看冰與火之歌

2. 代碼塊中html代碼顯示不正常，<、>被解析爲> <

   緣由：markdown是一個語法規範，具體的解析可使用不一樣的程序，而不一樣程序對規範的完成度也未必相同。hexo 所用的 marked 解析程序，沒法對代碼塊中<、>作正確解析，須要人工矯正。

   方法：標明語言類型html

   示例：

   解析爲：

3. 有序列表。

   問題：有序列表每項中包含若干段落時，這幾個列表項得不到正確解析。

   方法：在每一個列表項中各段落以前加一個空格。

   示例：

1 2 3 4 5 6 7

1. foo foo 2. bar bar

解析爲：

1. foo

   foo

2. bar

   bar

輕鬆搞定Markdown

以前寫過《Markdown指南》和《markdown 番外篇》用來介紹Markdown，前者是入門資料索引，後者是幾個稍微高級的用法，都只是介紹了片面，不太好。

使用Markdown寫博客已經三個月了，對這個標記語言非常喜歡。如今流行的教程，要麼就是太複雜太難以理解，要麼就是太簡單太膚淺，稍微高級點的用法沒有說起。本文的初衷就是用最容易理解的方式，把Markdown入門到高級用法一一介紹給讀者。看完以後，你不只能夠開始使用Markdown寫東西，在平常使用中也隨時能夠打開這篇博客參考各類用法。

爲何學習Markdown？別問爲何，儘管學習就行了。這麼簡單的東西，一會就能學會，受益可能終生，太值了。

怎麼學習Markdown？我認爲最好的方法是經過示例，本文正式採用這樣的方法。

在哪可使用Markdown？ 你能夠在簡書、Logdown這樣的免費平臺用Markdown寫博客。若是你願意折騰，也能夠像我同樣，使用hexo搭建本身的博客，並用Markdown書寫博客，請參考拙做《hexo系列教程》。另外，如今寫論文也流行使用Markdown，不學你就out了！

怎樣開始？打開這個網址，把下面學到的東西在這個裏面練習。左側是Markdown，右側是實時的顯示。

還要注意什麼？一個效果，有時候能夠經過不一樣的方式生成，好比無序列表能夠用- + *。本文從實踐出發，只列舉最好用的一種。讀者也只須要學習一種。

如下是Markdown代碼：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83

#這裏是一級標題 ###這裏是三級標題 ######這裏是六級標題，就到這裏了，木有七級！ 段落前面沒有縮進，看到了吧。 　　要想使用縮進，在中文輸入法中改爲「全角」輸入，再按兩個空格 行尾一個回車換行，顯示效果依然是是一行。 我說的對吧~ 想要分紅兩行，須要在行尾輸入兩個空格。 我說的對吧~ 想要開始一個新的段落，乖乖的按兩下回車吧 我說的對吧~ **兩個星號包圍的是粗體** *一個星號包圍的是斜體* > 引用內容，多行的話，用兩個空格結尾吧 是吧~ `反引號包圍的是行內代碼`，這個按鍵在「Tab」上邊 ``嵌套的話，可使用`兩個雙引號`嵌套在外面`` ```python #三個反引號包圍的是代碼塊。 #會顯示行號。 #也有高亮顯示 #我上面加了python，你也能夠不加。若是不能高亮，那麼仍是加上吧。。另外，若是你的代碼塊包圍的是html，那你應該寫html而不是python import os print os.sep ``` 嵌套的話，可使用六個反引號嵌套在外面。 1. 有序列表1，注意點以後的空格。 2. 有序列表2. 1. 我這裏寫成1，在顯示時仍是3，厲害不。 1. 有序列表1 詳細內容，注意前面有一個空格 2. 有序列表2 詳細內容 - 無序列表1 - 無序列表2 - 無序列表3 - 小1，注意前面有一個空格 - 小2 超級連接：[個人博客](http://zipperary.com) 插入圖片： 另外，markdown徹底兼容html，你能夠用html插入這些東西，例如： <iframe height=498 width=510 src="http://player.youku.com/embed/XMjI2MjU3MDMy" frameborder=0 allowfullscreen></iframe> ~~刪除線~~ 分割線用`---`，注意單獨同樣，上面必須是一個空行 --- 更多高級的格式，請果斷插入html標籤

如下到結尾處是效果：

這裏是一級標題

這裏是三級標題

這裏是六級標題，就到這裏了，木有七級！

段落前面沒有縮進，看到了吧。

　　要想使用縮進，在中文輸入法中改爲「全角」輸入，再按兩個空格

行尾一個回車換行，顯示效果依然是是一行。
我說的對吧~

想要分紅兩行，須要在行尾輸入兩個空格。
我說的對吧~

想要開始一個新的段落，乖乖的按兩下回車吧

我說的對吧~

兩個星號包圍的是粗體

一個星號包圍的是斜體

引用內容，多行的話，用兩個空格結尾吧
是吧~

反引號包圍的是行內代碼，這個按鍵在「Tab」上邊

嵌套的話，可使用`兩個雙引號`嵌套在外面

1 2 3 4 5 6

#三個反引號包圍的是代碼塊。 #會顯示行號。 #也有高亮顯示 #我上面加了python，你也能夠不加。若是不能高亮，那麼仍是加上吧。。另外，若是你的代碼塊包圍的是html，那你應該寫html而不是python import os print os.sep

嵌套的話，可使用六個反引號嵌套在外面。

1. 有序列表1，注意點以後的空格。
2. 有序列表2。
3. 我這裏寫成1，在顯示時仍是3，厲害不。

1. 有序列表1

   詳細內容，注意該行和上面一行，前面有一個空格

2. 有序列表2

   詳細內容

• 無序列表1
• 無序列表2
• 無序列表3
  • 小1，注意前面有一個空格
  • 小2

超級連接：個人博客

插入圖片：

好看不

另外，markdown徹底兼容html，你能夠用html插入這些東西，例如：

刪除線

分割線用---，注意單獨一行，上面必須是一個空行

---

更多高級的格式，請果斷插入html標籤