Markdown 詳細介紹

時間 2019-11-17

原文原文鏈接

Markdown 詳細介紹

文章來源: 陶老師運維筆記- 微信公衆號html

Markdown致力於使閱讀和創做文檔變得容易,讓寫做者專一於內容創做，不過多的花時間在排版及格式上。本文介紹MarkDown語法及如何編寫。

1. MarkDown 介紹

Markdown 在 2004 由John Gruber建立。是一種輕量級標記語言，可用於創做 web 文檔的。 Markdown 不是要取代 HTML . 它的語法集很是小, 只對應一小部分 HTML 標籤,目前 github、Stackoverflow 等網站均支持此格式。git

特色：程序員

Markdown 編寫的文檔後綴爲**.md**, .markdown。
純文本, 只要支持Markdown的地方都能得到同樣的效果，讓做者擺脫排版的困擾。
書寫語法簡單。
Markdown 編寫的文檔能夠導出 HTML 、Word、圖像、PDF、Epub 等多種格式的文檔。

2. MarkDown 語法

Markdown中文參考

www.markdown.cn/

markdown tutorial

www.mdeditor.com/

2.1標題

在 Markdown 中，你只須要在文本前面加上 # 便可，同理、你還能夠增長二級標題、三級標題、四級標題、五級標題和六級標題，總共六級，只須要增長 # 便可，標題字號相應下降。例如：github

# 一級標題
## 二級標題
### 三級標題
#### 四級標題
##### 五級標題
複製代碼

注： # 和「標題」之間建議保留一個字符的空格，這是最標準的 Markdown 寫法。web

2.2 文本格式

這是加粗的文字 這是傾斜的文字` 這是斜體加粗的文字 ~~這是加刪除線的文字~~chrome

**這是加粗的文字**
*這是傾斜的文字*`
***這是斜體加粗的文字***
~~這是加刪除線的文字~~
複製代碼

字體顏色:瀏覽器

<font color=red>我是紅色</font>
<font face="黑體" color=green size=5>我是黑體，綠色，尺寸爲5</font>

#簡書字體顏色:
$\color{red}{紅色字}$
複製代碼

簡書字體顏色設置: $\color{red}{紅色字}$ bash

2.3 列表

Markdown 支持有序列表和無序列表。無序列表使用星號*、加號+或是減號-任一做爲列表標記：例如：只須要在文字前面加上 -:服務器

文本1
文本2

- 文本1
- 文本2
- 文本3
複製代碼

若是你但願有序列表，能夠在文字前面加上 1. 2. 3. 就能夠了。例如：微信

文本1
文本2

注意：-、1.和文本之間要保留一個字符的空格。

2.4 連接

Markdown 支持兩種連接形式: 內聯和引用. 內聯連接： 連接展現文字是 [中括號括起]，用圓括號()放所需的 URL 連接。還能夠放一個可選的連接標題, 標題要用引號包圍。示例：

- [markdown](https://markdown-zh.readthedocs.io/)
- [百度](http://baidu.com)
複製代碼

引用 : 相同服務器下的本地資源, 還能夠用相對路徑示例：關於連接 About 示例。

關於連接 [About](/about/) 示例。
複製代碼

2.5 圖片

圖片: 插入圖片語法使用 ![](圖片連接地址) 這樣的語法便可，例如： [圖片上傳失敗...(image-e2afa5-1572700558513)]

![MacDown logo](http://macdown.uranusjr.com/static/images/logo-160.png)
複製代碼

注：插入圖片的語法和連接的語法很像，只是前面多了一個！

2.6 引用

在引用的文字前加>便可。引用也能夠嵌套，如加兩個>>三個>>>

www.markdown.cn/

> - [http://www.markdown.cn/](http://www.markdown.cn/)
複製代碼

2.7 表格

Markdown 製做表格使用 | 來分隔不一樣的單元格，使用 - 來分隔表頭和其餘行。

語法：
| 左對齊 | 右對齊 | 居中對齊 |
| :-----| ----: | :----: |
| 單元格 | 單元格 | 單元格 |
| 單元格 | 單元格 | 單元格 |

第二行分割表頭和內容。
- 有一個就行，爲了對齊，多加了幾個
文字默認居左
-兩邊加：表示文字居中
-右邊加：表示文字居右
注：原生的語法兩邊都要用 | 包起來。此處省略
複製代碼

示例：

左對齊	右對齊	居中對齊
單元格	單元格	單元格
單元格	單元格	單元格

設置表格的對齊方式： -: 設置內容和標題欄居右對齊。 :- 設置內容和標題欄居左對齊。 :-: 設置內容和標題欄居中對齊。

2.8 註釋

代碼格式：[xxxxx]:註釋說明在大括號[]內寫註釋內容，再加上你要寫的註釋說明便可。注意，註釋通常是回車以後的就失效了。如何作到多行註釋呢，上圖的最後一種 [^_^]: 格式就能夠啦，注意多行註釋時換行時要有兩個tab鍵的空格。

[xxxxx]:註釋說明
[^_^]:
    這是註釋
    就是不想讓你知道
複製代碼

2.9 代碼

單行代碼：代碼之間分別用一個反引號包起來。

`bash 代碼內容 `
複製代碼

代碼塊：代碼之間分別用三個反引號包起來，且兩邊的反引號單獨佔一行。

function fun(){
  echo "這是一句很是牛逼的代碼";
}
fun();
複製代碼

2.10 分隔線

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

示例:

* * *

***

*****

- - -

---------------------------------------
複製代碼

2.11 進階技能

流程圖: 示例: www.mdeditor.com/
進階技能: www.runoob.com/markdown/md…

3. 編輯器

使用文本編輯器就能夠寫Markdown。如程序員經常使用的編輯器 sublime, VScode 安裝插件後就能夠編寫Markdown。

3.1 MacDown

MacDown for mac基於MAC系統免費並開放源代碼的編輯器，官網： macdown.uranusjr.com。 國內下載連接: pan.baidu.com/s/1430Ebdrt… 提取碼: n2fa

###3.2 在線編輯器

www.mdeditor.com/
blog.didispace.com/tools/onlin… 帶有主題,格式美觀，推薦使用。

3.3 Chrome插件

markdown-here 是一個chrome插件，能夠支持markdown編寫。

安裝: 1.下載軟件： github.com/adam-p/mark… 從github下載markdown-here並解壓文件。 2.安裝插件 打開Chrome瀏覽器，更多工具-擴展程序。在Chrome-擴展程序中點選加載已解壓的擴展程序,指定插件文件目錄爲src目錄，完成安裝。