markdown命令语法

Fri, 04 Dec 2020 21:23:10 +0000

记录在此处，主要避免每次都要互联网中搜索，而是选择在本地就搜索，缩小这个知识的范围；

微信公众号排版工具。问题或建议，请公众号留言。程序员翻身

建议使用 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
有序列表 2
有序列表 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，列出全部标题。

[TOC]

由于微信只支持到二级列表，本工具仅支持二级标题和三级标题的显示。

3.5 注音符号

支持平台：微信公众号。

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

Markdown Nice 这么好用，简直是{喜大普奔|hē hē hē hē}呀！

3.6 横屏滑动幻灯片

支持平台：微信公众号。

通过<![](url),![](url)>这种语法设置横屏滑动滑动片，具体用法如下：

4 其他语法

4.1 HTML

支持原生 HTML 语法，请写内联样式，如下：

橙色居右橙色居中

4.2 UML

不支持，推荐使用开源工具https://draw.io/制作后再导入图片

5 致谢

歌词经理 wechat-fromat
颜家大少 MD2All

REF:

Markdown 基本语法 | Markdown 官方教程

markdown工具绘图

Fri, 04 Dec 2020 21:23:10 +0000

[toc]

千言万语不如一张图 Express yourself by Pic

给你一座灯塔，给你一个希望

Markdown可以绘制各种不同的图，依赖于mermaid 引擎¹。

Flowchart

Flowchart 都由节点、几何形状和边缘、箭头或线条组成。mermaid代码定义了这些节点和边的制作和交互方式²。

可能的flowchart 方向是：
- TB - 从上到下
- TD - 自上而下/与自上而下相同
- BT - 自下而上
- RL - 从右到左
- LR——从左到右

实例：

flowchart LR id1([start]) --> id2[需求基线确定] --> id3[内部需求变更]-->id4{是否对实际业务产生影响} id4-->|no|id5{是否接受当前版本变更} -->|no|id6[下一个版本] id4-->|yes|id7[与客户协商需求变更]-->id8[客户需求变更流程] id5-->|yes|id9[更新需求文档]-->id10[通知项目组开发测试]-->id11([需求变更备案])

Sequence

-» 代表实线箭头，–» 则代表虚线箭头
->直线，–>虚线

sequenceDiagram 李雷 -> 韩梅梅: Hello 梅梅, How are you? Note right of 韩梅梅: 韩梅梅心想韩梅梅 --> 李雷: I'm fine, thanks, and you?

Gantt

gantt dateFormat YYYY-MM-DD title 快乐的生活 section 吃一把鸡就学习学习 :done, des1, 2014-01-06,2014-01-09 疯狂学习 :active, des2, 2014-01-09, 3d 继续疯狂学习 : des3, after des2, 5d 吃鸡！ : des4, after des3, 4d section 具体内容学习Python :crit, done, 2014-01-06,72h 学习C++ :crit, done, after des1, 2d 学习Lisp :crit, active, 3d 学习图形学 :crit, 4d 跳伞 :2d 打枪 :2d

ClassDiagram

classDiagram Class01 <|-- AveryLongClass: Cool <> Class01 Class09-->C2: Where am i? Class09 --* C3 Class09 --|> Class07 Class07: equals() Class07: Object[] elementData Class01: size() Class01: int chimp Class01: int gorilla class Class10 { <> int id size() }

StateDiagram

stateDiagram [*]-->Active state Active { [*]-->NumLockOff NumLockOff-->NumLockOn : EvNumLockPressed NumLockOn-->NumLockOff : EvNumLockPressed -- [*]-->CapsLockOff CapsLockOff-->CapsLockOn : EvCapsLockPressed CapsLockOn-->CapsLockOff : EvCapsLockPressed -- [*]-->ScrollLockOff ScrollLockOff-->ScrollLockOn : EvCapsLockPressed ScrollLockOn-->ScrollLockOff : EvCapsLockPressed }

ErDiagram

erDiagram CUSTOMER ||--o{ORDER : places ORDER ||--|{LINE-ITEM : contains CUSTOMER}|..|{DELIVERY-ADDRESS : uses

GitGraph

gitGraph: options { "nodeSpacing": 150, "nodeRadius": 15 } end commit branch lelandBranch checkout lelandBranch commit commit checkout master commit commit commit merge lelandBranch

Pie

pie title Key elements in Product X "Calcium" : 42.96 "Potassium" : 50.05 "Magnesium" : 10.01 "Iron" : 5

Journey

展示了不同用户要做的步骤信息，可以展示当前的工作流

Task name: :

journey title My working day section Go to work Make tea: 5: Me Go upstairs: 3: Me Do work: 1 : Me, Cat section Go home Go downstairs: 5: Me Sit down: 3: Me

markdown | Liao Lile

markdown命令语法

1 Markdown.com.cn 简介

2 Markdown语法教程

2.1 标题

一级标题

二级标题

三级标题

2.2 字体

2.3 无序列表

2.4 有序列表

2.5 引用

2.7 链接

2.8 图片

2.9 分割线

2.10 表格

3. 特殊语法

3.1 脚注

3.2 代码块

3.3 数学公式

3.4 TOC

3.5 注音符号

3.6 横屏滑动幻灯片

4 其他语法

4.1 HTML

4.2 UML

5 致谢

markdown工具绘图

Flowchart

Sequence

Gantt

ClassDiagram

StateDiagram

ErDiagram

GitGraph

Pie

Journey