电竞比分网-中国电竞赛事及体育赛事平台

搜索
分享

【原】Markdown 使用手冊

 Stone_sy 2020-03-22

1. Markdown 是什么？

1.1 認識Markdown

Markdown是一種輕量級的 [ 標記語言 ] ，Markdown 是一個 Web 上使用的文本到HTML的轉換工具，可以通過簡單、易讀易寫的文本格式生成結構化的HTML文檔。目前面向開源及私有軟件項目的托管平臺—GitHub、中國專業(yè)IT社區(qū)—CSDN、優(yōu)質的創(chuàng)作社區(qū)—簡書等網(wǎng)站均支持這種格式。

GitHub基于搜狗微信搜索的微信公眾號爬蟲接口

1.2兼容 HTML

Markdown 語法的目標是：成為一種適用于網(wǎng)絡的書寫語言。

Markdown 不是想要取代 HTML，甚至也沒有要和它相近，它的語法種類很少，只對應 HTML 標記的一小部分。Markdown 的構想不是要使得 HTML 文檔更容易書寫。Markdown 的理念是，能讓文檔更容易讀、寫和隨意改。HTML 是一種發(fā)布的格式，Markdown 是一種書寫的格式。

2. Markdown 適合做什么？

Markdown 文本編輯器，在快速文字排版以及代碼編輯方面的效率是顯而易見的。使用人群方面，適合那些對碼字手速和排版順暢度有要求的人群，譬如碼農(nóng)、網(wǎng)站小編……

2.1 使用 Markdown 的優(yōu)點

  • 專注你的文字內(nèi)容而不是排版樣式，安心寫作。

  • 輕松的導出 HTML、PDF 和本身的 .md 文件。

  • 純文本內(nèi)容，兼容所有的文本編輯器與字處理軟件。

  • 可讀、直觀、學習成本低。

2.2 使用 Markdown 的誤區(qū)

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

我們堅信寫作寫的是內(nèi)容，所思所想，而不是花樣格式。

Typora 也不是沒有缺點。相較于老牌的Word ，在功能方面Typora 還稍顯稚嫩，一些功能尚且不足。比如對于插入的圖片，Typora 不能對其設置樣式、裁剪等，而Word 則表示笑而不語。

但換一個角度來說，這也不是 Typora 的問題，因為它和 Word 完全是兩個不同定位的文本編輯器，只能說各有側重。

雖然功能的豐富并沒有什么本質的缺點，但終歸有些背離初衷，何況在編寫的過程中很費神，不如使用專業(yè)的工具撰寫來的更有效率，所以如果你需實現(xiàn)復雜功能，專業(yè)的圖形界面工具會更加方便。

3. Markdown 編輯器推薦

3.1 Typora

如果你是一個內(nèi)心文藝、熱愛寫文的程序員，那么你可能會想，到底有沒有一款既接近程序員碼字風格，又可以用于普通文本排版的編輯器呢？答案肯定是有的，它就是 Typora [' t? p?:ra]  。

Typora刪除了預覽窗口，以及所有其他不必要的干擾。實時渲染的特點「所見即所得」（What You See Is What You Mean）。Typora 同樣支持 Windows、OS X 和 Linux。

官網(wǎng)下載 下載合適的版本，并傻瓜式安裝即可

3.2 其他平臺

3.2.1 macOS 平臺

在 macOS 上可以使用 Ulysses[ 尤利西斯 ]，其次還有很多同類選擇。

3.2.2 iOS、Android 、Web 平臺

  • iOS、Android端已有相當多的APP支持Markdown 語法編輯，例如 Drafts、Day One、iA Writer 等。

  • Web 端，簡書，CSDN，微信公眾號等。

參考：

各個平臺的編輯器

推薦幾款Mac平臺上不錯的Markdown軟件

4. Markdown 語法

4.1 Typora 的 markdown 語法

看到這里請不要被 [ 標記 ] 、[ 語言 ] 所迷惑，Markdown的語法十分簡單。常用的標記符號也不超過十個，這種相對于更為復雜的HTML 標記語言來說，Markdown 可謂是十分輕量的，學習成本也不需要太多，且一旦熟悉這種語法規(guī)則，加上高效的快捷鍵操作，會有一勞永逸的效果。

Markdown由 約翰·格魯伯 創(chuàng)建。但是，其語法在不同的解析器或編輯器之間有所不同。

1、標題

  • ctrl + 數(shù)字鍵

  • 用#空格表示，依次增加#，對應標題1-6號標題

    效果：

2、引用

  • Ctrl + Shift + Q

  • > + 空格 + 內(nèi)容

    效果：

此處是引用

無限次嵌套引用

3、有序列表

  • Ctrl + Shift + [

  • 1. + 空格 + 內(nèi)容

    效果：

4、無序列表

  • Ctrl + Shift + ]

  • -或+或* + 空格 + 內(nèi)容

    效果：

5、任務清單

支持GFM任務列表。能夠在markdown文件中管理簡單的待辦事項。

  • - + 空格 + [ 空格 ] + 空格 + 內(nèi)容

    效果：

6、代碼塊

Typora支持 java，python 等多種編程語言，并且在代碼區(qū)域進行語法高亮，用Typora記編程筆記，看得一清二楚！

  • Ctrl + Shift + K

  • ``` + 語言名 + 回車

    效果：

7、公式塊

7.1 Typora 原生支持  Tex / LaTeX 美[?le?teks] 語法，可用來渲染普通數(shù)學、化學方程式。 渲染過程由MathJax處理。

LaTeX 是一種基于 TeX 的排版系統(tǒng)，由于它易于快速生成復雜表格和數(shù)學公式，非常適用于生成高印刷質量的科技和數(shù)學類文檔。如果你常閱讀數(shù)學、計算機等領域的學術論文，一定對 LaTeX 不陌生。 

7.2 Typora 可繪制流程圖、時序圖(順序圖)、甘特圖

  • Ctrl + Shift + M

  • $$ + 回車，可輸入各種公式

  • $x^2+\cos(\theta)$

    效果：

    內(nèi)聯(lián)公式：

8、生成表格

  • Ctrl + T

  • 在一般的 Markdown 編輯器中，你可以通過以下的格式插入表格：

| 第一個標題 | 第二個標題  | 第三個標題|

| -----------------| -----------------| ---------------|

|      單元格     |     單元格     |     單元格   |

  • 上面的麻煩，但好在 Typora 為我們提供了圖形界面的插入表格的功能，你只需要在行內(nèi)鼠標右鍵 - 插入 - 表格 ，并輸入行數(shù)和列數(shù)，Typora 就會自動生成一張樣式不錯的空表格。

  • 調整Markdown文件中表格大小的最快步驟：只需拖動鼠標即可。

    效果：


























9、字體加粗

  • Ctrl + B

  • **兩邊各兩個星號**

  • __兩邊各兩個下劃線__

    效果：字體加粗

           字體加粗

10、字體傾斜

  • Ctrl + I

  • *內(nèi)容*

  • _內(nèi)容_

    效果：字體傾斜

          字體傾斜

    • 粗斜體文本

    • 粗斜體文本

11、下劃線

  • Ctrl + U

  • <u>內(nèi)容</u>

    效果：下劃線

12、刪除線

  • Alt + Shift + 5

  • ~~內(nèi)容~~

    效果：刪除線

13、分割線

可以在一行中用三個以上的星號、減號、底線來建立一個分隔線，行內(nèi)不能有其他東西。你也可以在星號或是減號中間插入空格 。

  • -------------------

    效果：

14、插入鏈接

  • Ctrl + K

  • [顯示的文字](鏈接 "鏈接標題")

  • 允許您插入URL作為鏈接  <顯示的網(wǎng)址>

效果：

  1. 鏈接

  2. 鏈接

  3. www.google.com

15、插入圖片

  • Ctrl + Shift + I

  • ![顯示的文字](路徑 "圖片標題")

  1. 本地直接拖拉圖片到編輯頁面。

  2. 如果使用markdown構建網(wǎng)站 ，配合 MPic，上傳圖床并復制鏈接到編輯頁面。（推薦）

16、視頻

可以使用HTML標簽嵌入視頻。

  • <video src="xxx.mp4">

17、插入腳注

  • 第一行：內(nèi)容+[^1]+回車

  • 第二行：[^1]: + 腳注內(nèi)容

(注意：在英文半角的輸入法下輸入符號，輸入腳注內(nèi)容后，可移動鼠標到第一行腳注上可看到腳注內(nèi)容)

效果：今天還好嗎？12

[1]    好著來，??

[2]    那么你如何？

17、插入目錄(TOC)

  • [toc] + 回車

18、下標、上標、高亮

  • H~2~O

  • X^2^2

  • ==高亮==

效果：

  1. H2O

  2. X2

  3. 高亮

19、反斜杠

  • Markdown 支持以下這些符號前面加上反斜杠來幫助插入普通的符號。

20、表情符號??

  • 英文狀態(tài)下的引號，輸入字母自動顯示表情符號

  • win10快捷鍵：win + .

  • 微軟輸入法快捷鍵：Ctrl + Shift + B

以上語法不用刻意記，在Typora中的右鍵菜單都有， 常用功能基本上都有快捷鍵。

4.2 Typora特色

4.2.1 文件

  1. 快速打開：Ctrl + P

  2. 自動保存(注：需在文件->偏好設置->通用 打開該功能)

  3. md 文件導出

Typora 支持十余種文本格式的導出，默認的有 PDF、HTML，此外它還支持主流的 Word文檔，小眾一些有 Epub、RTF 格式…等等，同時它還支持把文本導出為圖片，方便快捷。你可以根據(jù)軟件內(nèi)提示安裝 Pandoc 插件來導出更多例如 docx，LaTeX 等格式。

對于Typora，Pandoc的安裝是可選的，如果您不需要Typora中的高級導入/導出支持，則不必在計算機上安裝Pandoc安裝和使用Pandoc

4.2.2 主題

為了讓文檔更美觀，我們可以為其加上 CSS style。我認為 Typora 對 CSS 的支持讓它成為一眾桌面筆記應用中最與眾不同的一個。在 Typora 中 CSS 被稱為「主題」，但其本質仍是 CSS 文件。你可以在 文件 - 偏好設置 - 主題 - 打開主題文件夾 看到這些 CSS 文件。

選擇不同的主題可以使文檔擁有不同的外觀，但不會影響內(nèi)容。Typora 自帶了若干主題，你也可以在官方主題下載更多的主題。

4.2.3 視圖

  1. 側邊欄：Ctrl + Shift + L 或者 左下角第一個按鈕

  2. 專注模式：F8 使得你所編輯的那一行永遠處于屏幕正中

  3. 打字機模式：F9使你正在編輯的那一行保留顏色，而其他行的字體呈灰色

  4. 源代碼模式：Ctrl + / 或者 左下角第二個按鈕

參考網(wǎng)站：

1.Typora官方指南

2. 史上最完美的Typora教程

3. Markdown 中文版語法說明

5、Markdown相關資源共享

5.1博客搭建

Typora 支持在文檔頭部加上基于 YAML 的 front-matter 信息，這一特性適用于把 Markdown 文檔分類歸檔上傳到用 Hexo 框架搭建的博客中。

Stone  Sun's Blog

博客搭建參考網(wǎng)站

5.2圖床推薦

圖床選擇參考網(wǎng)址

6、Markdown總結

Markdown的語法簡潔明了、學習容易，而且功能比純文本更強，可用于寫博客，寫幫助文檔，同時多種網(wǎng)站均支持這種格式。學習的同時，學會分享才能共同進步！

    轉藏 分享 獻花（0）

    0條評論

    發(fā)表

    請遵守用戶 評論公約

    類似文章 更多