請(qǐng)使用 Chrome 瀏覽器。
請(qǐng)閱讀下方文本熟悉工具使用方法,本文可直接拷貝到微信中預(yù)覽。
1 Markdown Nice 簡(jiǎn)介
支持自定義樣式的 Markdown 編輯器 支持微信公眾號(hào)、知乎和稀土掘金 歡迎掃碼回復(fù)「排版」加入用戶群
2 主題
https://preview.mdnice.com/themes/
歡迎提交主題,提供更多文章示例~~
3 通用語(yǔ)法
3.1 標(biāo)題
在文字寫書寫不同數(shù)量的#
可以完成不同的標(biāo)題,如下:
一級(jí)標(biāo)題
二級(jí)標(biāo)題
三級(jí)標(biāo)題
3.2 無序列表
無序列表的使用,在符號(hào)-
后加空格使用。如下:
無序列表 1 無序列表 2 無序列表 3
如果要控制列表的層級(jí),則需要在符號(hào)-
前使用空格。如下:
無序列表 1 無序列表 2 無序列表 2.1 無序列表 2.2
由于微信原因,最多支持到二級(jí)列表。
3.3 有序列表
有序列表的使用,在數(shù)字及符號(hào).
后加空格后輸入內(nèi)容,如下:
有序列表 1 有序列表 2 有序列表 3
3.4 粗體和斜體
粗體的使用是在需要加粗的文字前后各加兩個(gè)*
。
而斜體的使用則是在需要斜體的文字前后各加一個(gè)*
。
如果要使用粗體和斜體,那么就是在需要操作的文字前后加三個(gè)*
。如下:
這個(gè)是粗體
這個(gè)是斜體
這個(gè)是粗體加斜體
注:由于 commonmark 標(biāo)準(zhǔn),可能會(huì)導(dǎo)致加粗與想象不一致,如下
**今天天氣好晴朗,**處處好風(fēng)光。
這個(gè)是正,F(xiàn)象,請(qǐng)參考加粗 Issue[1]。
3.5 鏈接
微信公眾號(hào)僅支持公眾號(hào)文章鏈接,即域名為https://mp.weixin.qq.com/
的合法鏈接。使用方法如下所示:
對(duì)于該論述,歡迎讀者查閱之前發(fā)過的文章,你是《未來世界的幸存者》么?
3.6 引用
引用的格式是在符號(hào) >
后面書寫文字,文字的內(nèi)容可以包含標(biāo)題、鏈接、圖片、粗體和斜體等。
一級(jí)引用如下:
一級(jí)引用示例
讀一本好書,就是在和高尚的人談話。 ——歌德
當(dāng)使用多個(gè) >
符號(hào)時(shí),就會(huì)變成多級(jí)引用
二級(jí)引用如下:
二級(jí)引用示例
讀一本好書,就是在和高尚的人談話。 ——歌德
三級(jí)引用如下:
三級(jí)引用示例
讀一本好書,就是在和高尚的人談話。 ——歌德
3.7 分割線
可以在一行中用三個(gè)以上的減號(hào)來建立一個(gè)分隔線,同時(shí)需要在分隔線的上面空一行。如下:
3.8 刪除線
刪除線的使用,在需要?jiǎng)h除的文字前后各使用兩個(gè)~
,如下:
這是要被刪除的內(nèi)容。
3.9 表格
可以使用冒號(hào)來定義表格的對(duì)齊方式,如下:
姓名 | 年齡 | 工作 |
---|---|---|
小可愛 | 18 | 吃可愛多 |
小小勇敢 | 20 | 爬棵勇敢樹 |
小小小機(jī)智 | 22 | 看一本機(jī)智書 |
寬度過長(zhǎng)的表格可以滾動(dòng),可在自定義主題中調(diào)節(jié)寬度:
姓名 | 年齡 | 工作 | 郵箱 | 手機(jī) |
---|---|---|---|---|
小可愛 | 18 | 吃可愛多 | lovely@test.com | 18812345678 |
小小勇敢 | 20 | 爬棵勇敢樹 | brave@test.com | 17712345678 |
小小小機(jī)智 | 22 | 看一本機(jī)智書 | smart@test.com | 16612345678 |
3.10 圖片
插入圖片,如果是行內(nèi)圖片則無圖例,否則有圖例,格式如下:
可以通過在圖片尾部添加寬度和高度控制圖片大小,用法如下:
該語(yǔ)法比較特殊,其他 Markdown 編輯器不完全通用。
支持 jpg、png、gif、svg 等圖片格式,其中 svg 文件僅可在微信公眾平臺(tái)中使用,svg 文件示例如下:
支持圖片拖拽和截圖粘貼到編輯器中上傳,上傳時(shí)使用當(dāng)前選擇的圖床。 可使用格式->圖片上傳本地圖片,網(wǎng)站目前支持「圖殼」圖床,失敗率低,但是只可保存一天用于排版
注:僅支持 https 的圖片,圖片粘貼到微信、知乎或掘金時(shí)會(huì)自動(dòng)上傳其服務(wù)器,不必?fù)?dān)心使用上述圖床會(huì)導(dǎo)致圖片丟失。
圖片還可以和鏈接嵌套使用,能夠?qū)崿F(xiàn)推薦卡片的效果,用法如下:
4. 特殊語(yǔ)法
4.1 腳注
支持平臺(tái):微信公眾號(hào)、知乎。
腳注與鏈接的區(qū)別如下所示:
鏈接:[文字](鏈接)
腳注:[文字](腳注解釋 "腳注名字")
有人認(rèn)為在大前端時(shí)代[2]的背景下,移動(dòng)端開發(fā)(Android、IOS)將逐步退出歷史舞臺(tái)。
全棧工程師[3]在業(yè)務(wù)開發(fā)流程中起到了至關(guān)重要的作用。
腳注內(nèi)容請(qǐng)拉到最下面觀看。
4.2 代碼塊
支持平臺(tái):微信公眾號(hào)、知乎。
如果在一個(gè)行內(nèi)需要引用代碼,只要用反引號(hào)引起來就好,如下:
Use the printf()
function.
在需要高亮的代碼塊的前一行及后一行使用三個(gè)反引號(hào),同時(shí)第一行反引號(hào)后面表示代碼塊所使用的語(yǔ)言,如下:
// FileName: HelloWorld.java
public class HelloWorld {
// Java 入口程序,程序從此入口
public static void main(String[] args) {
System.out.println("Hello,World!"); // 向控制臺(tái)打印一條語(yǔ)句
}
}
支持以下語(yǔ)言種類:
bash
clojure,cpp,cs,css
dart,dockerfile, diff
erlang
go,gradle,groovy
haskell
java,ja vasc ript,json,julia
kotlin
lisp,lua
makefile,markdown,matlab
ob jectivec
perl,php,python
r,ruby,rust
scala,shell,sql,swift
tex,typesc ript
verilog,vhdl
xm l
yaml
如果想要更換代碼主題,可在上方挑選,不支持代碼主題自定義。
其中微信代碼主題與微信官方一致,有以下注意事項(xiàng):
帶行號(hào)且不換行,代碼大小與官方一致 需要在代碼塊處標(biāo)志語(yǔ)言,否則無法高亮 粘貼到公眾號(hào)后,用鼠標(biāo)點(diǎn)代碼塊內(nèi)外一次,完成高亮
diff 不能同時(shí)和其他語(yǔ)言的高亮同時(shí)顯示,且需要調(diào)整代碼主題為微信代碼主題以外的代碼主題才能看到 diff 效果,使用效果如下:
+ 新增項(xiàng)
- 刪除項(xiàng)
其他主題不帶行號(hào),可自定義是否換行,代碼大小與當(dāng)前編輯器一致
4.3 數(shù)學(xué)公式
支持平臺(tái):微信公眾號(hào)、知乎。
行內(nèi)公式使用方法,比如這個(gè)化學(xué)公式:
塊公式使用方法如下:
矩陣:
公式由于微信不支持,目前的解決方案是轉(zhuǎn)成 svg 放到微信中,無需調(diào)整,矢量不失真。
目前測(cè)試如果公式量過大,在 Chrome 下會(huì)存在粘貼后無響應(yīng),但是在 Firefox 中始終能夠成功。
4.4 TOC
支持平臺(tái):微信公眾號(hào)、知乎。
TOC 全稱為 Table of Content,列出全部標(biāo)題。由于示例標(biāo)題過多,需要使用將下方代碼段去除即可。
[TOC]
由于微信只支持到二級(jí)列表,本工具僅支持二級(jí)標(biāo)題和三級(jí)標(biāo)題的顯示。
4.5 注音符號(hào)
支持平臺(tái):微信公眾號(hào)。
支持注音符號(hào),用法如下:
Markdown Nice 這么好用,簡(jiǎn)直是喜大普奔呀!
4.6 橫屏滑動(dòng)幻燈片
支持平臺(tái):微信公眾號(hào)。
通過<![](url),![](url)>
這種語(yǔ)法設(shè)置橫屏滑動(dòng)滑動(dòng)片,具體用法如下:
5 其他語(yǔ)法
5.1 HTML
支持原生 HTML 語(yǔ)法,請(qǐng)寫內(nèi)聯(lián)樣式,如下:
橙色居右 橙色居中
5.2 UML
不支持,推薦使用開源工具https://draw.io/
制作后再導(dǎo)入圖片
5.3 更多文檔
更多文檔請(qǐng)參考 markdown-nice-docs[4]
加粗 Issue: https://github.com/markdown-it/markdown-it/issues/410
[2]Front-end web development: https://en.wikipedia.org/wiki/Front-end_web_development
[3]什么是全棧工程師: 是指掌握多種技能,并能利用多種技能獨(dú)立完成產(chǎn)品的人。
[4]更多文檔: https://preview.mdnice.com/articles/