1. 程式人生 > 其它 >Markdown 基本語法(文章測試)

Markdown 基本語法(文章測試)

微信公眾號排版工具。問題或建議,請公眾號留言。程式設計師翻身

建議使用 Chrome 瀏覽器,體驗最佳效果。

使用微信公眾號編輯器有一個十分頭疼的問題:粘貼出來的程式碼,格式錯亂,空間小還帶行號,而且特別醜。Markdown.com.cn編輯器能夠解決這個問題。

Markdown是一種輕量級的「標記語言」。

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

1 Markdown.com.cn 簡介

  • 支援自定義樣式的 Markdown 編輯器
  • 支援微信公眾號、知乎和稀土掘金
  • 點選右上方對應圖示,一鍵複製到各平臺

2 Markdown語法教程

2.1 標題

不同數量的#可以完成不同的標題,如下:

一級標題

二級標題

三級標題

2.2 字型

粗體、斜體、粗體和斜體,刪除線,需要在文字前後加不同的標記符號。如下:

這個是粗體

這個是斜體

這個是粗體加斜體

這裡想用刪除線~

注:如果想給字型換顏色、字型或者居中顯示,需要使用內嵌HTML來實現。

2.3 無序列表

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

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

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

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

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

2.4 有序列表

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

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

2.5 引用

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

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

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

2.7 連結

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

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

2.8 圖片

插入圖片,格式如下:

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

支援圖片拖拽和截圖貼上

到編輯器中。

注:支援圖片 拖拽和截圖貼上 到編輯器中,僅支援 https 的圖片,圖片貼上到微信時會自動上傳微信伺服器。

2.9 分割線

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


2.10 表格

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

姓名 年齡 工作
小可愛 18 吃可愛多
小小勇敢 20 爬棵勇敢樹
小小小機智 22 看一本機智書

3. 特殊語法

3.1 腳註

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

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

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

有人認為在大前端時代的背景下,移動端開發(Android、IOS)將逐步退出歷史舞臺。

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

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

3.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 效果,使用效果如下:

+ 新增項
- 刪除項

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

3.3 數學公式

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

行內公式使用方法,比如這個化學公式:\(\ce{Hg^2+ ->[I-] HgI2 ->[I-] [Hg^{II}I4]^2-}\)

塊公式使用方法如下:

\[H(D_2) = -\left(\frac{2}{4}\log_2 \frac{2}{4} + \frac{2}{4}\log_2 \frac{2}{4}\right) = 1 \]

矩陣:

\[ \begin{pmatrix} 1 & a_1 & a_1^2 & \cdots & a_1^n \\ 1 & a_2 & a_2^2 & \cdots & a_2^n \\ \vdots & \vdots & \vdots & \ddots & \vdots \\ 1 & a_m & a_m^2 & \cdots & a_m^n \\ \end{pmatrix} \]

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

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

3.4 TOC

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

TOC 全稱為 Table of Content,列出全部標題。

目錄

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

3.5 注音符號

支援平臺:微信公眾號。

支援注音符號,用法如下:

Markdown Nice 這麼好用,簡直是{喜大普奔|hē hē hē hē}呀!

3.6 橫屏滑動幻燈片

支援平臺:微信公眾號。

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

,
,

4 其他語法

4.1 HTML

支援原生 HTML 語法,請寫內聯樣式,如下:

橙色居右
橙色居中

4.2 UML

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

5 致謝