markdown簡明語法

收藏自:http://ibruce.info/2013/11/26/markdown/html

Markdown是一種極簡的『標記語言』,將文本轉爲HTML,一般爲我大碼農所用。其不追求大而全,簡潔至上,正所謂不求最貴,只求最好!git

本文介紹Markdown基本語法,內容不多,一行語法一行示例,學會後可輕鬆寫出高大上的文檔,不再須要各類編輯器去調文章格式。另外,網上有 各平臺下的Markdown工具可用,也有在線的,我直接使用sublime搞定,Markdown原本就是爲了追求簡潔,弄個工具豈很少此一舉。github

強調


星號與下劃線均可以,單是斜體,雙是粗體,符號可跨行,符號可加空格
**一我的來到田納西**

__毫無疑問__
*我作的餡餅
是全天下*
_最好吃的_

一我的來到田納西編程

毫無疑問
我作的餡餅
是全天下

最好吃的ubuntu

分割線


三個或更多-_*,必須單獨一行,可含空格
---

引用


翻譯成html就是<blockquote></blockquote>,符號後的空格可不要
> 引用

引用ruby

內層符號前的空格必需要
>引用
>>引用中的引用

引用markdown

引用中的引用hexo

標題:Setext方式


三個或更多
大標題
===
小標題
---

大標題

小標題

標題:Atx方式


#一級標題
##二級標題
###三級標題
####四級標題
#####五級標題
######六級標題

一級標題

二級標題

三級標題

四級標題

五級標題
六級標題

無序列表


符號以後的空格不能少,-+*效果同樣,但不能混合使用,因混合是嵌套列表,內容可超長
- 無序列表
- 無序列表
- 無序列表
- 無序列表:我很長。我也很長!那比一比啊?比就比!我有這麼長,你有我長嗎?我有這麼這麼長!好吧,你贏了!
  • 無序列表
  • 無序列表
  • 無序列表
  • 無序列表:我很長。我也很長!那比一比啊?比就比!我有這麼長,你有我長嗎?我有這麼這麼長!好吧,你贏了!
符號以後的空格不能少,-+*效果同樣,但不能混合使用,因混合是嵌套列表
+ 無序列表
+ 無序列表
+ 無序列表
  • 無序列表
  • 無序列表
  • 無序列表
符號以後的空格不能少,-+*效果同樣,但不能混合使用,因混合是嵌套列表
* 無序列表
* 無序列表
* 無序列表
  • 無序列表
  • 無序列表
  • 無序列表

有序列表


數字不能省略但可無序,點號以後的空格不能少
1. 有序列表
2. 有序列表
3. 有序列表
8. 有序列表
  1. 有序列表
  2. 有序列表
  3. 有序列表
  4. 有序列表

嵌套列表


-+*可循環使用,但符號以後的空格不能少,符號以前的空格也不能少
- 嵌套列表
+ 嵌套列表
+ 嵌套列表
- 嵌套列表
* 嵌套列表
- 嵌套列表
  • 嵌套列表
    • 嵌套列表
    • 嵌套列表
      • 嵌套列表
        • 嵌套列表
  • 嵌套列表

文字超鏈:Inline方式


Tooltips可省略
[不如](http://bruce-sha.github.io "不如的博客")

不如編程語言

圖片超鏈


多個感嘆號,Tooltips可省略,要設置大小隻能借助HTML標記
![GitHub Mark](http://github.global.ssl.fastly.net/images/modules/logos_page/GitHub-Mark.png "GitHub Mark")

GitHub MarkGitHub Mark編輯器

索引超鏈:Reference方式


索引,1 2能夠是任意字符
[不如][1]
![GitHub Octocat][2]

[1]:http://bruce-sha.github.io
[2]:http://github.global.ssl.fastly.net/images/modules/logos_page/Octocat.png

不如
GitHub OctocatGitHub Octocat

自動連接


尖括號
<http://ibruce.info>
<bu.ru@qq.com>

http://ibruce.info

bu.ru@qq.com

代碼:行內代碼


在第一行後指定編程語言,也能夠不指定
<!--0-->
val s = "hello Markdown"
println( s )

代碼:段落代碼


每行文字前加4個空格或者1個Tab
val s = "hello Markdown"
println( s )
val s = "hello Markdown" println( s ) 

代碼:hexo


可指定編程語言,『』表明左右大括號
『% codeblock [title] [lang:language] [url] [link text] %』
code snippet
『% endcodeblock %』

註釋


用html的註釋,好像只有這樣?
<!-- 註釋 -->

轉義字符


用html的註釋,好像只有這樣?
Markdown中的轉義字符爲\,轉義的有:
\\ 反斜槓
\` 反引號
\* 星號
\_ 下劃線
\{\} 大括號
\[\] 中括號
\(\) 小括號
\# 井號
\+ 加號
\- 減號
\. 英文句號
\! 感嘆號

其它


文本中可直接用html標籤,可是要先後加上空行。

one more thing:表格


Markdown的擴展語法,hexo不支持
|| *Year* || *Temperature (low)* || *Temperature (high)* ||
|| 1900 || -10 || 25 ||
|| 1910 || -15 || 30 ||
|| 1920 || -10 || 32 ||

結束語


以上基本夠用,更詳盡的請參考文獻10,另外Markdown+R能夠幹大事,請參考文獻7

參考文獻


  1. Markdown 簡明語法
  2. Markdown之表格的處理
  3. 獻給寫做者的 Markdown 新手指南
  4. Cmd Markdown 編輯閱讀器
  5. Markdown語法說明(詳解版)
  6. 怎樣使用Markdown
  7. Markdown寫做淺談
  8. Markdown語法示例
  9. HTML轉義字符對照表
  10. Markdown 語法說明(簡體中文版)
相關文章
相關標籤/搜索