我的 MarkDown 學習筆記


MarkDown 一種用於寫作的輕量級【標記語言】。它用簡潔的語法代替排版,而不像一般的文字處理軟件 Word 或者 Pages 有大量的排版、字體設置等。

如果你對文章的樣式沒有太多要求,只注重寫文章本身的話 MarkDown 將會是一個不錯的選擇。

一、工具

支持 MarkDown 寫作的軟件有很多,因為國外平台的國內訪問大都不太穩,這里就列舉幾個國內常用的:

  • 簡書 博客平台,書寫的時候每隔幾秒鍾就會自動備份一次,需要注冊才能使用。

  • 馬克飛象 付費軟件,對於映像筆記用戶來說是個不錯的選擇。

  • Cmd MarkDown 作業部落的產品,跨平台,支持 Windows、Linux、Mac 和 Web。而且提供了備份等功能。

  • Atom 著名的 Github 推出的編輯器,功能強大,支持原生實時預覽。實時預覽快捷鍵 ctrl+shift+m 。

二、基本語法

MarkDown 對於標題呀、字體呀等可能有多種寫法。個人建議初學的時候記憶一種語法就好,待熟練后若有興趣可多記幾種。

1.標題

MarkDown 支持 1~6 級標題,通過加在標題文字前的 # 來區分。例如,

# 這是一級標題
## 這是二級標題
...
###### 這是六級標題

Tips: # 和標題文字之間是有一個空格的。

2.段落

很簡單,一行文字就是一個段落。例如,

這是一行文字,MarkDown 中的段落。

如果要換行,那么兩行之間要隔一個空行。例如,

這是一行文字,MarkDown 中的段落。
                               //這行是空行
這是另一行文字,MarkDown 中的段落。

3.粗體和斜體

Markdown 中字體的粗體和斜體用 ** * ** 表示。例如,

*這里是斜體*
**這里是粗體**
***這里是粗體 + 斜體***

效果如下:

這里是斜體

這里是粗體

這里是粗體 + 斜體

4.刪除線

可能有一部分編輯器不支持這個元素。刪除線用 ~ 定義。例如,

~~這里有刪除線~~

效果如下:

這里有刪除線

Tips: 刪除線要用兩個 ~ 來包裹文字。

5.引用

在一行文字前添加大於號 > 來使用引用格式。例如,

>這里是引用句子。

效果如下:

這里是引用句子。

引用可以嵌套使用,例如:

>>這里使用了嵌套引用。

效果如下:

這里使用了潛逃引用。

也可以嵌套其他格式。例如,

> ## 嵌套一個二級標題。
> *嵌套斜體字。*
> **嵌套粗體字。**

效果如下:

嵌套一個二級標題。

嵌套斜體字。

嵌套粗體字。

6.列表

列表分為無序列表和有序列表。

無序列表使用加號、減號和星號來標記。例如,

+ 加號列表
+ 加號列表
+ 加號列表

+ 減號列表
+ 減號列表
+ 減號列表

+ 星號列表
+ 星號列表
+ 星號列表

效果如下:

  • 加號列表

  • 加號列表

  • 加號列表

  • 減號列表

  • 減號列表

  • 減號列表

  • 星號列表

  • 星號列表

  • 星號列表

有序列表使用數字加上英文句點標記。

1.有序列表
2.有序列表
3.有序列表

7.內聯代碼

內聯代碼用反引號 ` 表示。例如,

`code`

有的地方說用單個 ` 即可表示內聯代碼,由於我用的是 Atom 編輯器,
單個 ` 不起作用,只好用兩個 ` 將代碼包裹起來。如果代碼中有反引號 ` ,
也可以兩個反引號將它包裹起來,但是要加空格。例如,

` ` `

效果如下:

code

`

8.代碼塊

有兩種風格,原生和 Github 。

原生風格,首行縮進四個空格。例如,

這是一個普通段落。

    這是一個代碼塊。

效果如下:

這是一個普通段落。

這是一個代碼塊。

Github 風格,代碼塊的前后用三個反引號獨占一行來標記。效果如下,

這里是代碼塊。

9.分割線

分割線可以用三個以上的星號、減號或者底線來標識,行內不能有其他東西,但是可以插入空格。例如,

***

* * *

---

- - -

___

_ _ _

效果如下:







10.鏈接

鏈接用下面的格式標識。例如,

[鏈接要顯示的文字](http://www.zhihu.com "鼠標箭頭放到鏈接上的提示文字,可以不寫,與鏈接之間留有空格")

效果如下:

鏈接要顯示的文字

還可以用另外的格式標識,

[鏈接要顯示的文字][id]

在任意空白位置,

[id]:http://www.zhihu.com "鼠標箭頭放到鏈接上的提示文字,可以不寫,與鏈接之間留有空格"

效果也是一樣的,

鏈接要顯示的文字

11.自動鏈接

如果鏈接的地址和要顯示的文字一樣的話,可以用尖括號將其包裹形成自動連接。例如,

<http://www.zhihu.com>

效果如下:

http://www.zhihu.com

12.圖片

圖片的標識與鏈接類似。語法如下,

![圖片不存在時的提示文字](http://images.cnblogs.com/cnblogs_com/zhangyn/922022/o_%e6%89%8b.jpg "鼠標箭頭放到圖片上的提示文字")

效果如下:

圖片不存在時的提示文字

![圖片不存在時的提示文字][imgid]
[imgid]:http://images.cnblog.com/cnblogs_com/zhangyn/922022/o_手.jpg "鼠標箭頭放到圖片上的提示文字"

圖片的 MarkDown 標識與 HTML 標簽有對應的關系,關系如下,

![img alt 屬性](img 地址 “img title 屬性”)

<img src='img 地址' alt='img alt 屬性' title='img title 屬性'>

13.轉義

支持在前面插入反斜杠轉義的字符如下,

\			反斜線
`			反引號
*			星號
_			底線
{}		花括號
[]		方括號
()		括弧
#			井字號
+			加號
-			減號
.			英文句點
!			驚嘆號

效果如下:

\ 反斜線

` 反引號

* 星號

_ 底線

{} 花括號

[] 方括號

() 括弧

# 井字號

+ 加號

- 減號

. 英文句點

! 驚嘆號

14.表格

原本是 Github 風格的語法,大部分編輯器都支持。

| 鍵 | 值 | 備注 |
|----|----:|:------:|
|MacBookPro|¥12000|辦公用品|
|打印機|¥12000|辦公用品|
|台式電腦|¥12000|辦公用品|

效果如下:

備注
MacBookPro ¥12000 辦公用品
打印機 ¥1200 辦公用
台式電腦 ¥120

Tips:第一行表頭可以不要,第二行必須要有,第二行的冒號標識表中內容居左、居右還是劇中,如果不加冒號默認居左。

15.**內嵌 HTML **

MarkDown 保留了內嵌 HTML 的語法,標簽中的內容都會輸入到結果中。例如,

<html>
  <body>
    <iframe frameborder="no" border="0" marginwidth="0" marginheight="0" width=330 height=86 src="//music.163.com/outchain/player?type=2&id=64517&auto=0&height=66"></iframe>
  </body>
</html>

效果如下:

竟然沒顯示出來zz....

16.目錄

只要按照 MarkDown 語法書寫,在需要生成目錄的地方寫[TOC] 就可以生成目錄了。

三、綜述

至此,就可以用 MarkDown 來寫一般的文章啦。當然,如果有特殊的需求,比如:輸入公式或者畫 UML 圖,那么可以參考下面的鏈接:

MarkDown Tex 公式輸入語法參考

MarkDown 時序圖語法參考

MarkDown 流程圖語法參考


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM