1 Markdown Nice 簡介

• 支持自定義樣式的 Markdown 編輯器
• 支持微信公眾號、知乎和稀土掘金
• 歡迎掃碼回復(fù)「排版」加入推文群

2 主題

https://product.mdnice.com/themes/

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

3 通用語法

3.1 標(biāo)題

在文字寫書寫不同數(shù)量的#可以完成不同的標(biāo)題，如下：

一級標(biāo)題

二級標(biāo)題

三級標(biāo)題

3.2 無序列表

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

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

如果要控制列表的層級，則需要在符號-前使用空格。如下：

• 無序列表 1
• 無序列表 2
• 無序列表 2.1
• 無序列表 2.2

由于微信原因，最多支持到二級列表。

3.3 有序列表

有序列表的使用，在數(shù)字及符號.后加空格后輸入內(nèi)容，如下：

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

3.4 粗體和斜體

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

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

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

這個是粗體

這個是斜體

這個是粗體加斜體

注：由于 commonmark 標(biāo)準(zhǔn)，可能會導(dǎo)致加粗與想象不一致，如下

**今天天氣好晴朗，**處處好風(fēng)光。

這個是正常現(xiàn)象，請參考加粗 Issue^[1]。

3.5 鏈接

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

對于該論述，歡迎讀者查閱之前發(fā)過的文章，你是《未來世界的幸存者》么？

3.6 引用

引用的格式是在符號 > 后面書寫文字，文字的內(nèi)容可以包含標(biāo)題、鏈接、圖片、粗體和斜體等。

一級引用如下：

一級引用示例

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

Markdown Nice最全功能介紹

當(dāng)使用多個 > 符號時，就會變成多級引用

二級引用如下：

二級引用示例

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

Markdown Nice最全功能介紹

三級引用如下：

三級引用示例

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

Markdown Nice最全功能介紹

3.7 分割線

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

3.8 刪除線

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

這是要被刪除的內(nèi)容。

3.9 表格

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

寬度過長的表格可以滾動，可在自定義主題中調(diào)節(jié)寬度：

3.10 圖片

插入圖片，如果是行內(nèi)圖片則無圖例，否則有圖例，格式如下：

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

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

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

• 支持圖片拖拽和截圖粘貼到編輯器中上傳，上傳時使用當(dāng)前選擇的圖床。
• 可使用格式->圖片上傳本地圖片，網(wǎng)站目前支持「圖殼」圖床，失敗率低，但是只可保存一天用于排版

注：僅支持 https 的圖片，圖片粘貼到微信、知乎或掘金時會自動上傳其服務(wù)器，不必?fù)?dān)心使用上述圖床會導(dǎo)致圖片丟失。

圖片還可以和鏈接嵌套使用，能夠?qū)崿F(xiàn)推薦卡片的效果，用法如下：

4. 特殊語法

4.1 腳注

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

腳注與鏈接的區(qū)別如下所示：

鏈接：[文字](鏈接)
腳注：[文字](腳注解釋 "腳注名字")

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

全棧工程師^[3]在業(yè)務(wù)開發(fā)流程中起到了至關(guān)重要的作用。

腳注內(nèi)容請拉到最下面觀看。

4.2 代碼塊

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

如果在一個行內(nèi)需要引用代碼，只要用反引號引起來就好，如下：

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

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

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

• 帶行號且不換行，代碼大小與官方一致
• 需要在代碼塊處標(biāo)志語言，否則無法高亮
• 粘貼到公眾號后，用鼠標(biāo)點代碼塊內(nèi)外一次，完成高亮

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

+ 新增項
- 刪除項

其他主題不帶行號，可自定義是否換行，代碼大小與當(dāng)前編輯器一致

4.3 數(shù)學(xué)公式

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

行內(nèi)公式使用方法，比如這個化學(xué)公式：

塊公式使用方法如下：

矩陣：

公式由于微信不支持，目前的解決方案是轉(zhuǎn)成 svg 放到微信中，無需調(diào)整，矢量不失真。

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

4.4 TOC

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

TOC 全稱為 Table of Content，列出全部標(biāo)題。由于示例標(biāo)題過多，需要使用將下方代碼段去除即可。

[TOC]

由于微信只支持到二級列表，本工具僅支持二級標(biāo)題和三級標(biāo)題的顯示。

4.5 注音符號

支持平臺：微信公眾號。

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

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

4.6 橫屏滑動幻燈片

支持平臺：微信公眾號。

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

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

5 其他語法

5.1 HTML

支持原生 HTML 語法，請寫內(nèi)聯(lián)樣式，如下：

橙色居右橙色居中

5.2 UML

不支持，推薦使用開源工具https://draw.io/制作后再導(dǎo)入圖片

5.3 更多文檔

更多文檔請參考 mdnice 產(chǎn)品主頁^[4]

參考資料