開篇提示: MarkDown使用文章大同小異,可以參考簡書官方的文章 獻給寫作者的 MarkDown 新手指南 或 MarkDown官網
文章目錄:
- Why MarkDown
- MarkDown 基礎用法
- MarkDown 編輯器推薦
- 如何將 MarkDown 導出為 PDF
<br />
Why MarkDown
MarkDown是現在比較流行的文檔寫作工具,用它來寫的文檔通常以.md
結尾,適合全程鍵盤操作的文檔書寫。學習成本低,半小時就可以學會并且運用。
現在筆記類應用也基本支持MarkDown,許多網站文章發布也支持MarkDown語法??梢娝?strong>用途廣泛。程序員需要用它來寫說明文檔readme.md
本文主要是介紹一些MarkDown的基礎語法,并且推薦一些鏈接來學習,再羅列幾款常見的編輯器。我列的不一定是最好的,僅供參考。
<br />
MarkDown基礎語法
MarkDown是支持HTML
語法的,所以如果你會了解一些HTML
標簽運用,也可以使用在MarkDown的寫作中。
標題
從標題開始吧。不同個數的井號代表著不同級別的標題,1級是最高的,字體也最大。井號個數最多是6個,即六級標題已經是最小的標題了。注:#
后最好加一個空格,有些地方不加空格無法顯示
# 一級標題
## 二級標題
...
段落與換行
段落的前后必須是空行,相鄰兩行文本,如果中間沒有空行 會顯示在一行中(換行符被轉換為空格)??梢栽谇耙恍械哪┪布尤胫辽偃齻€空格,然后換行寫其它的文字。
要注意在MarkDown中再多的空格與換行都會變成一個,所以可以嘗試使用:
換行:<br>
空格: (none-break-space)
分隔線: 可以在一行中使用三個或更多的 *、- 或 _ 來添加分隔線(<hr>)
文字效果
這里的文字效果指,斜體,加粗,刪除線 效果。上下標
斜體:使用一個星號 * 包裹, *斜體*
加粗:二個星號包裹 **加粗**
刪除線:使用兩個波浪線包裹 ~~ 刪除線 ~~
上標:<sup> </sup>
下標:<sub> </sub>
代碼塊&代碼引用
代碼引用效果
這是單行引用的。而之前的成段灰色背景則是塊引用的。
單行代碼引用,使用兩個點 `我是代碼` ,即tab上面的鍵
成段代碼引用: 使用三個點開頭,并用三個點 ``` 結束,包裹部分為代碼塊
注意三個點要獨占一行
引用
使用一個大于號>
,后面加一個空格即可引用,引用完畢后加一個空行即可跳出引用
這是引用效果
圖片&超鏈接
圖片和超鏈都是先用方括號包裹描述部分,然后緊跟圓括號內包裹地址,兩者區別就是前面有無感嘆號。要注意這些符號都是在英文狀態下輸入
[圖片上傳失敗...(image-1b07d5-1551955291923)]
[超鏈接描述](超鏈接地址)
列表
- 有序列表項目1
- 項目1
圓點列表:使用減號加一個空格 -
有序列表:使用數字加一個點. 然后一個空格 1. 2. 3.
星號列表:使用一個星號加個空格 *
表格
可以在表格兩側加上豎線 也可以不加
name | age
---- | ---
Jan | 22
Zen | 10
name | age |
---|---|
Jan | 22 |
Zen | 10 |
表格對齊方式: 在表頭下方的分隔線標記中加入 冒號:
,即可標記下方單元格內容的對齊方式:
-
:---
代表左對齊 -
:--:
代表居中對齊 -
---:
代表右對齊
name | age
----: | :---:
Jan | 22
Zen | 10
name | age |
---|---|
Jan | 22 |
Zen | 10 |
關于表格,更多用法可以參考:
Learning-Markdown (Markdown 入門參考)
MarkDown 在線使用練習地址
<br />
MarkDown的編輯器
常用的一些代碼編輯器(如VScode/autom)也是支持MarkDown的,下面就是羅列三款在win下比較流行的專屬MarkDown編輯器。
-
MarkDownEditor:功能十分十分強大,并且支持云服務,pdf導出,實時預覽以及目錄跳轉,還有良好的文檔管理,就是在win下啟動速度有些慢。
性質:付費軟件,普通版 58rmb,Pro 128rmb。(也可以永久免費試用)
更多功能展示,點擊 功能演示視頻
官網下載: 下載地址
MarkDownEditor展示界面
-
Typora :這款編輯最大的特色就是簡潔,可以實時預覽,即輸入文字后立即展示。完全免費
下載地址: 官網地址
Typora預覽界面
-
MarkDownpad :功能比Typora強大些,可以導出HTML,也支持預覽,類似于簡書的預覽模式。支持多種MarkDown模式,缺點是需要激活碼,經常有些小問題。
下載地址: 官網地址
MarkDownpad預覽
以上編輯器的推薦順序與羅列的順序一致。
<br />
導出Markdown為PDF
- 使用編輯器的內置方法,導出
.md
為PDF - 先導入到HTML,然后使用打印選項,選擇導出為PDF
- 使用VScode里的相關插件:
MarkDown PDF
- 某些筆記軟件有導出MarkDown為PDF的選項,比如為知筆記(收費)(不推薦)
最后,希望以上提到的軟件,可以給我提供五毛的贊助費,謝謝。