請使用 Chrome 瀏覽器。

請閱讀下方文字熟悉工具使用方法，本文可直接拷貝到微信中預覽。

1 Markdown Nice 簡介

• 支援自定義樣式的 Markdown 編輯器
• 支援微信公眾號、知乎和稀土掘金
• 歡迎掃碼回覆「排版」加入使用者群

2 主題

https://preview.mdnice.com/themes/

歡迎提交主題，提供更多文章示例~~

3 通用語法

3.1 標題

在文字寫書寫不同數量的#可以完成不同的標題，如下：

一級標題

二級標題

三級標題

3.2 無序列表

無序列表的使用，在符號-後加空格使用。如下：

• 無序列表 1
• 無序列表 2
• 無序列表 3

如果要控制列表的層級，則需要在符號-

• 無序列表 1
• 無序列表 2

  • 無序列表 2.1
  • 無序列表 2.2

由於微信原因，最多支援到二級列表。

3.3 有序列表

有序列表的使用，在數字及符號.後加空格後輸入內容，如下：

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

3.4 引用

引用的格式是在符號>後面書寫文字。如下：

讀一本好書，就是在和高尚的人談話。 ——歌德

僱用制度對工人不利，但工人根本無力擺脫這個制度。 ——阮一峰

3.5 粗體和斜體

粗體的使用是在需要加粗的文字前後各加兩個*。

而斜體的使用則是在需要斜體的文字前後各加一個*。

如果要使用粗體和斜體，那麼就是在需要操作的文字前後加三個*。如下：

這個是粗體

這個是斜體

這個是粗體加斜體

注：由於 commonmark 標準，可能會導致加粗與想象不一致，如下

**今天天氣好晴朗，**處處好風光。

這個是正常現象，請參考加粗 Issue^[1]。

3.6 連結

微信公眾號僅支援公眾號文章連結，即域名為https://mp.weixin.qq.com/的合法連結。使用方法如下所示：

對於該論述，歡迎讀者查閱之前發過的文章，你是《未來世界的倖存者》麼？

3.7 分割線

可以在一行中用三個以上的減號來建立一個分隔線，同時需要在分隔線的上面空一行。如下：

3.8 刪除線

刪除線的使用，在需要刪除的文字前後各使用兩個~，如下：

這是要被刪除的內容。

3.9 表格

可以使用冒號來定義表格的對齊方式，如下：

寬度過長的表格可以滾動，可在自定義主題中調節寬度：

3.10 圖片

插入圖片，如果是行內圖片則無圖例，否則有圖例，格式如下：

可以通過在圖片尾部新增寬度和高度控制圖片大小，用法如下：

該語法比較特殊，其他 Markdown 編輯器不完全通用。

支援 jpg、png、gif、svg 等圖片格式，其中 svg 檔案僅可在微信公眾平臺中使用，svg 檔案示例如下：

• 支援圖片拖拽和截圖貼上到編輯器中上傳，上傳時使用當前選擇的圖床。
• 可使用格式->圖片上傳本地圖片，網站僅支援「圖殼」圖床，失敗率低可長久儲存！

注：僅支援 https 的圖片，圖片貼上到微信時會自動上傳微信伺服器，不必擔心使用上述圖床會導致微信內圖片丟失。

圖片還可以和連結巢狀使用，能夠實現推薦卡片的效果，用法如下：

4. 特殊語法

4.1 腳註

支援平臺：微信公眾號、知乎。

腳註與連結的區別如下所示：

連結：[文字](連結)
腳註：[文字](腳註解釋 "腳註名字")

有人認為在大前端時代^[2]的背景下，移動端開發（Android、IOS）將逐步退出歷史舞臺。

全棧工程師^[3]在業務開發流程中起到了至關重要的作用。

腳註內容請拉到最下面觀看。

4.2 程式碼塊

支援平臺：微信程式碼主題僅支援微信公眾號！其他主題無限制。

如果在一個行內需要引用程式碼，只要用反引號引起來就好，如下：

Use the printf() function.

在需要高亮的程式碼塊的前一行及後一行使用三個反引號，同時第一行反引號後面表示程式碼塊所使用的語言，如下：

// FileName: HelloWorld.java
public class HelloWorld {
  // Java 入口程式，程式從此入口
  public static void main(String[] args) {
    System.out.println("Hello,World!"); // 向控制檯列印一條語句
  }
}

支援以下語言種類：

bash
clojure，cpp，cs，css
dart，dockerfile, diff
erlang
go，gradle，groovy
haskell
java，javascript，json，julia
kotlin
lisp，lua
makefile，markdown，matlab
objectivec
perl，php，python
r，ruby，rust
scala，shell，sql，swift
tex，typescript
verilog，vhdl
xml
yaml

如果想要更換程式碼主題，可在上方挑選，不支援程式碼主題自定義。

其中微信程式碼主題與微信官方一致，有以下注意事項：

• 帶行號且不換行，程式碼大小與官方一致
• 需要在程式碼塊處標誌語言，否則無法高亮
• 貼上到公眾號後，用滑鼠點程式碼塊內外一次，完成高亮

diff 不能同時和其他語言的高亮同時顯示，且需要調整程式碼主題為微信程式碼主題以外的程式碼主題才能看到 diff 效果，使用效果如下:

+ 新增項
- 刪除項

其他主題不帶行號，可自定義是否換行，程式碼大小與當前編輯器一致

4.3 數學公式

支援平臺：微信公眾號、知乎。

行內公式使用方法，比如這個化學公式：[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}" alt>

塊公式使用方法如下：

矩陣：

公式由於微信不支援，目前的解決方案是轉成 svg 放到微信中，無需調整，向量不失真。

目前測試如果公式量過大，在 Chrome 下會存在粘貼後無響應，但是在 Firefox 中始終能夠成功。

4.4 TOC

支援平臺：微信公眾號、知乎。

TOC 全稱為 Table of Content，列出全部標題。由於示例標題過多，需要使用將下方程式碼段去除即可。

[TOC]

由於微信只支援到二級列表，本工具僅支援二級標題和三級標題的顯示。

4.5 注音符號

支援平臺：微信公眾號。

支援注音符號，用法如下：

Markdown Nice 這麼好用，簡直是喜大普奔hē hē hē hē呀！

4.6 橫屏滑動幻燈片

支援平臺：微信公眾號。

通過<![](url),![](url)>這種語法設定橫屏滑動滑動片，具體用法如下：

<<< 左右滑動見更多 >>>

5 其他語法

5.1 HTML

支援原生 HTML 語法，請寫內聯樣式，如下：

橙色居右 橙色居中

5.2 UML

不支援，推薦使用開源工具https://draw.io/製作後再匯入圖片

5.3 更多文件

更多文件請參考 markdown-nice-docs^[4]

參考資料

本文使用 mdnice 排版