1. 程式人生 > 程式設計 >一文了解文件寫作利器 Markdown

一文了解文件寫作利器 Markdown

一、前言

無論你是軟體開發者,還是網際網路寫作者,為了使自己寫的文件或作品更好的流通,便於在不同場合、不同環境、不同人群的檢視,亟需尋求一種通用、便於扭轉、留存的文件格式。

在這之前、現在或者今後,你可能會存在以下這些困擾:

  • 作為軟體開發者、架構師,寫的設計文件到底應該以什麼樣的格式來儲存呢?是word、txt、pdf,還是html呢?這些文件格式,在不同情況下,可能都會存在。有時為了便於評審、修改,會採用word格式;有時為了防止文件篡改,會採用pdf格式;有時為了便於網頁瀏覽(如:GitLib),會採用html格式。難道要針對不同格式進行不同的編寫嗎?
  • 作為網際網路寫作者,寫的文章希望能夠在不同的平臺能夠發表,分享給更多的人。而在不同網際網路平臺,如:微信公眾號、CSND、知乎、有道雲筆記等,文章的排版會花費你大量的時間,不同平臺排版上也會存在一些差異性,甚至讓你抓狂。難道不同平臺要進行不同排版的調整嗎?

辦法總比困難多! 上述的這些困擾,Markdown就能很好的解決,接下來我們一起來了解下它吧。

二、Markdown是什麼

Markdown是一種可以使用普通文字編輯器編寫的標記語言,通過簡單的標記語法,它可以使普通文字內容具有一定的格式。

Markdown具有一系列衍生版本,用於擴充套件Markdown的功能(如表格、腳註、內嵌HTML等等),這些功能原初的Markdown尚不具備,它們能讓Markdown轉換成更多的格式,例如LaTeX,Docbook。Markdown增強版中比較有名的有Markdown Extra、MultiMarkdown、 Maruku等。這些衍生版本要麼基於工具,如Pandoc;要麼基於網站,如GitHub和Wikipedia,在語法上基本相容,但在一些語法和渲染效果上有改動。

Markdown也是最受歡迎的寫作"標記語言",它的簡潔語法代替了排版,而不像一般我們用的字處理軟體Word有大量的排版、字型設定等。它使我們更專心於碼字,用"標記"語法,來替代常見的排版格式。

目前,支援Markdown語法的編輯器、平臺、工具有很多,如:CSDN、簡書、GitLab等,有的還支援了Markdown的匯入、常見格式的匯出,都十分的方便、高效。

優點

  • 專注你的文字內容而不是排版樣式,安心寫作。
  • 輕鬆的匯出 HTML、PDF 和本身的 .md 檔案。
  • 純文字內容,相容所有的文字編輯器與字處理軟體。
  • 隨時修改你的文章版本,不必像字處理軟體生成若干檔案版本導致混亂。
  • 可讀、直觀、學習成本低。

誤區

We believe that writing is about content,about what you want to say – not about fancy formatting.

我們堅信寫作寫的是內容,所思所想,而不是花樣格式。

Markdown旨在簡潔、高效,也由於Markdown的易讀易寫,人們用不同的程式語言實現了多個版本的解析器和生成器,這就導致了目前不同的Markdown工具集成了不同的功能(基礎功能大致相同),例如流程圖與時序圖,複雜表格與複雜公式的呈現,雖然功能的豐富並沒有什麼本質的缺點,但終歸有些背離初衷,何況在編寫的過程中很費神,不如使用專業的工具撰寫來的更有效率,所以如果你需實現複雜功能,專業的圖形介面工具會更加方便。當然,如果你對摺騰這些不同客戶端對 Markdown 的定製所帶來高階功能感到愉悅的話,那也是無可厚非的。

三、Markdown語法

下面介紹的是最常用的Markdown語法,包括語法說明、效果展示。其中,同一種類效果可能會有多種寫法,第一種為標準語法,不同Markdown編輯器,會支援不同的特殊語法,並且展示效果上有細微差異。

1、標題

使用#標籤表示標題,#和標題之間必須有空格。一級標題使用一個#,二級標題使用兩個##,以此類推,共有六級標題。

語法如下:

# 標題H1
## 標題H2
### 標題H3
#### 標題H4
##### 標題H5
###### 標題H6

效果如下:

一文了解文件寫作利器 Markdown

2、字元效果

  • 刪除線:使用~~刪除線~~或<s>刪除線</s>標籤
  • 斜體字:使用*斜體字*或_斜體字_標籤
  • 粗體字:使用**粗體字**或__粗體字__標籤
  • 上標:使用O<sup>2</sup>標籤
  • 下標:使用X<sub>2</sub>標籤
  • 縮寫:使用HTML中的abbr標籤,如:HTML

語法如下:

~~刪除線1~~ <s>刪除線2</s> 
*斜體字1* _斜體字2_ 
**粗體字1** __粗體字2__ 
X<sub>2</sub> 
O<sup>2</sup> 
The <abbr title="Hyper Text Markup Language">HTML</abbr> specification is maintained by the <abbr title="World Wide Web Consortium">W3C</abbr>.

效果如下:

一文了解文件寫作利器 Markdown

3、引用

使用>標籤表示引用,>>標籤表示引用裡面再套一層引用,依次類推。

語法如下:

>這是一級引用文字內容 
>>這是二級引用文字內容 
>>>這是三級引用文字內容

效果如下:

一文了解文件寫作利器 Markdown

4、程式碼高亮

程式碼塊:

使用3個連續的` 標籤包圍起來。

語法如下:

一文了解文件寫作利器 Markdown

效果如下:

一文了解文件寫作利器 Markdown

行內程式碼:

使用``標籤表示行內程式碼。

語法如下:

執行命令:`npm install marked`

效果如下:

一文了解文件寫作利器 Markdown

5、連結

使用[](link)標籤表示連結。其中,[]內的內容為要新增連結的文字,link為連結地址。

語法如下:

[普通連結](https://blog.csdn.net/xcbeyond) 
[普通連結帶標題](https://blog.csdn.net/xcbeyond "普通連結帶標題") 
直接連結:https://blog.csdn.net/xcbeyond

效果如下:

一文了解文件寫作利器 Markdown

6、圖片

使用![Alt text](/path/to/img.jpg)標籤匯入圖片。其中,Alt text為如果圖片無法顯示時顯示的文字,/path/to/img.jpg為圖片所在路徑。

語法如下:

![](https://www.mdeditor.com/images/logos/markdown.png)

效果如下:

一文了解文件寫作利器 Markdown

7、列表

列表分為有序列表、無序列表,如下:

  • 有序列表:使用1. 2. 3.標籤表示,其中.後面有一個空格的。
  • 無序列表:使用*-+標籤表示。

有序列表:

語法如下:

1. 第一行
2. 第二行
3. 第三行

效果如下:

一文了解文件寫作利器 Markdown

無序列表:

語法如下:

+ 列表一
+ 列表二
  + 列表二-1
  + 列表二-2
  + 列表二-3
* 列表三
  * 列表三-1
  * 列表三-2
  * 列表三-3

效果如下:

一文了解文件寫作利器 Markdown

8、分割線

使用---***或者* * *標籤表示水平分割線,其中大於三個。

語法如下:

---
***
* * *

效果如下:

一文了解文件寫作利器 Markdown

9、表格

語法如下:

| Heading | Heading | Heading |
| ------- | ------- | ------- |
|  Cell |  Cell |  Cell |
|  Cell |  Cell |  Cell |

| Heading | Heading | Heading |
| :----- | :----: | ------: |
| 左對齊 | 居中 | 右對齊 |
| 左對齊 | 居中 | 右對齊 |

效果如下:

一文了解文件寫作利器 Markdown

10、流程圖

流程圖常用的有一般流程圖、序列圖,不同Markdown編輯器,語法也是不同的。如下分別說明了其中一種寫法,其他寫法可自行具體查閱相關資料。

(注:個別編輯器可能無法正常顯示效果。)

流程圖:

語法如下:

一文了解文件寫作利器 Markdown

效果如下:

一文了解文件寫作利器 Markdown

序列圖:

語法如下:

一文了解文件寫作利器 Markdown

效果如下:

一文了解文件寫作利器 Markdown

四、Markdown常用編輯器及工具

如何更好的使用Markdown,工具必不可少,在此介紹我用過的幾款工具,分享給大家,以滿足不同使用場景。

對於工具而言,只要自己用著順手,就是最好的

1、Typora

Typora是一款輕便簡潔的Markdown編輯器,支援即時渲染技術,這也是與其他Markdown編輯器最顯著的區別。即時渲染使得你寫Markdown就想是寫Word文件一樣流暢自如,不像其他編輯器的有編輯欄和顯示欄。並且支援多種主題以供選擇,如:GitHub、Newsprint等,如下圖所示。

官方地址:https://www.typora.io/

一文了解文件寫作利器 Markdown

2、MarkdownPad2

MarkdownPad2是一個windows上的Markdown編輯器,需下載安裝,便於離線使用,如下圖所示。

官方地址:http://markdownpad.com/

一文了解文件寫作利器 Markdown

3、Mou

Mou是Mac上的Markdown編輯器,兩欄介面,直觀清爽,功能簡潔到位,而且免費,如小圖所示。

不僅如此,Mou還有一些有趣的偏好設定(Preference),例如主題(Themes)與樣式(CSS),它們可以配置出定制化的文字編輯效果與匯出效果,如果你對自帶的主題與樣式不滿意還可以到 GitHub上搜索其它愛好者為Mou編寫的更多主題樣式,匯入的方式可以在偏好設定的Themes或CSS選項中選擇reload。

官方地址:http://25.io/mou/

一文了解文件寫作利器 Markdown

4、MdEditor

mdeditor是一個線上編輯markdown的工具,無需本地安裝,線上隨時編輯、直接預覽、隨時匯出,還提供對應標籤的圖示快捷操作,如下圖所示。

線上編輯完後,可匯出儲存到本地.md檔案即可。

官方地址:https://www.mdeditor.com/

一文了解文件寫作利器 Markdown

5、coolaf md

我姑且就叫它為coolaf md,它是一款線上Markdown編輯、各種格式匯出的工具,支援匯出Word、HTML、PDF格式的文件,非常好用,強烈推薦使用,如下圖所示。

官方地址:http://coolaf.com/tool/md

一文了解文件寫作利器 Markdown

6、Md2All

Md2All是一款線上Markdown編輯,方便複製貼上,一鍵排版,自定義CSS,80多種程式碼高亮,所有的樣式渲染非常完美,包括圖片加字也有方案支援。無需作任何調整就能一鍵複製到微信公眾號、部落格園、掘金、知乎、csdn、51cto等平臺,如下圖所示。

官方地址:http://md.aclickall.com/

一文了解文件寫作利器 Markdown

參考文章:

https://zhuanlan.zhihu.com/p/92312642https://www.jianshu.com/p/1e402922ee32http://markdownpad.com/http://25.io/mou/

到此這篇關於一文了解文件寫作利器 Markdown 的文章就介紹到這了,更多相關Markdown 寫作利器內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!