强大的文档书写语言-Markdown

代码小郭...大约 26 分钟

强大的文档书写语言-Markdown

强烈推荐官方语法教程👍👍👍

Markdown 是一种轻量级标记语言，它允许人们使用易读易写的纯文本格式编写文档。 Markdown 语言在 2004 由约翰·格鲁伯（英语：John Gruber）创建。 Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。 Markdown 编写的文档后缀为 .md, .markdown。

建议安装Typoa工具书写Markdown语法的文章，支持实时预览！

下面列出的都是我写作时常用的markdown语法，以备随时可以查阅，毕竟好记性不如烂笔头。

图片

用法一

<img src="http://cdn.gydblog.com/images/logo.png"  style="zoom: 20%;margin:0 auto;display:block"/><br/>

示例：

用法二(带底部文字说明)

![底部说明文字](http://cdn.gydblog.com/images/logo.png)

示例：

底部说明文字

区块高亮

提示色，内容使用"::: tip"开始，使用":::"结束

::: tip
文本内容
:::

示例效果：

提示

这里是一个使用提示色的区块

警告色：

::: warning
文本内容
:::

示例：

注意

这里是一个使用警告色的区块

标题

标准语法是在文字前面加#和空格，一个#是一级标题，二个#是二级标题，以此类推。支持六级标题

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

中划线

要划上中划线的文字左右分别用两个~~包起来

加粗

要加粗的文字左右分别用两个*包起来

上角标

^ 内容 ^
例如 2³¹:

  2^31^

下角标

~ 内容 ~
例如 H₂O

  H~2~O

分割线

可用三个以上的减号、星号、底线在一空行中建立一条分隔线，中间可以插入空格，但行内不能有其他东西。

---
***
___

效果如下:

引用

引用的格式是在符号>后面书写文字。如下：

> 读一本好书，就是在和高尚的人谈话。 ——歌德

> 雇用制度对工人不利，但工人根本无力摆脱这个制度。 ——阮一峰

效果：

读一本好书，就是在和高尚的人谈话。 ——歌德

雇用制度对工人不利，但工人根本无力摆脱这个制度。 ——阮一峰

有序列表

有序列表的使用，在数字及符号.后加空格后输入内容，如下：

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

效果：

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

无序列表

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

- 无序列表 1
- 无序列表 2
- 无序列表 3

如果要控制列表的层级，则需要在符号-前使用空格。如下：

- 无序列表 1
- 无序列表 2
  - 无序列表 2.1
  - 无序列表 2.2

效果：

无序列表 1
无序列表 2
无序列表 3

无序列表 1
无序列表 2
- 无序列表 2.1
- 无序列表 2.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 效果，使用效果如下:

+ 新增项
- 删除项

其他主题不带行号，可自定义是否换行，代码大小与当前编辑器一致

如果想要代码块折叠效果，可以用如下标签：

<details>
  <summary>查看代码</summary>
  <pre><code>  
  &nbsp;
    public void interrupt(){
      
    }
  &nbsp;
  </code></pre>
</details>

示例效果：

查看代码

  
   
    public void interrupt(){}

表格

要添加表，请使用三个或多个连字符（---）创建每列的标题，并使用管道（|）分隔每列。您可以选择在表的任一端添加管道。格式如下

| Syntax      | Description |
| ----------- | ----------- |
| Header      | Title       |
| Paragraph   | Text        |

效果如下：

Syntax	Description
Header	Title
Paragraph	Text

超链接

链接文本放在中括号内，链接地址放在后面的括号中，链接title可选。

超链接Markdown语法代码：

[超链接显示名](超链接地址 "超链接title")

对应的HTML代码：

<a href="超链接地址" title="超链接title">超链接显示名</a>

示例：

这是一个链接 [菜鸟教程|HashMap](https://www.runoob.com/java/java-hashmap.html)。

效果如下：
这是一个链接菜鸟教程|HashMapopen in new window。

颜色

字体颜色
修改字体颜色，选择颜色名称，例如：

<font color="Blue">Test</font>

效果为：

修改字体颜色，选择16进制颜色值，例如：

<font color="#00F0FF">Test</font>

效果为：

背景颜色
修改背景颜色，选择颜色名称，例如：

//方式1：
<font style="background:red">Test</font>
//方式2:
<span style=background:red>Test</span>

效果为： Test

修改背景颜色，选择16进制颜色值，例如：

//方式1：
<font style="background:#FF0000">Test</font>
//方式2:
<span style="background:#FF0000">Test</span>

效果为： Test

支持的颜色

颜色可以选择下表的颜色名称，或者根据RGB值。

支持的各种颜色名称如下：

HTML	示例	颜色名称	16进制
`<font color=AliceBlue>`	`<font color=AliceBlue>Test</font>`	AliceBlue	#F0F8FF
`<font color=AntiqueWhite>`	`<font color=AntiqueWhite>Test</font>`	AntiqueWhite	#FAEBD7
`<font color=Aqua>`	`<font color=Aqua>Test</font>`	Aqua	#00FFFF
`<font color=Aquamarine>`	`<font color=Aquamarine>Test</font>`	Aquamarine	#7FFFD4
`<font color=Azure>`	`<font color=Azure>Test</font>`	Azure	#F0FFFF
`<font color=Beige>`	`<font color=Beige>Test</font>`	Beige	#F5F5DC
`<font color=Bisque>`	`<font color=Bisque>Test</font>`	Bisque	#FFE4C4
`<font color=Black>`	`<font color=Black>Test</font>`	Black	#000000
`<font color=BlanchedAlmond>`	`<font color=BlanchedAlmond>Test</font>`	BlanchedAlmond	#FFEBCD
`<font color=Blue>`	`<font color=Blue>Test</font>`	Blue	#0000FF
`<font color=BlueViolet>`	`<font color=BlueViolet>Test</font>`	BlueViolet	#8A2BE2
`<font color=Brown>`	`<font color=Brown>Test</font>`	Brown	#A52A2A
`<font color=BurlyWood>`	`<font color=BurlyWood>Test</font>`	BurlyWood	#DEB887
`<font color=CadetBlue>`	`<font color=CadetBlue>Test</font>`	CadetBlue	#5F9EA0
`<font color=Chartreuse>`	`<font color=Chartreuse>Test</font>`	Chartreuse	#7FFF00
`<font color=Chocolate>`	`<font color=Chocolate>Test</font>`	Chocolate	#D2691E
`<font color=Coral>`	`<font color=Coral>Test</font>`	Coral	#FF7F50
`<font color=CornflowerBlue>`	`<font color=CornflowerBlue>Test</font>`	CornflowerBlue	#6495ED
`<font color=Cornsilk>`	`<font color=Cornsilk>Test</font>`	Cornsilk	#FFF8DC
`<font color=Crimson>`	`<font color=Crimson>Test</font>`	Crimson	#DC143C
`<font color=Cyan>`	`<font color=Cyan>Test</font>`	Cyan	#00FFFF
`<font color=DarkBlue>`	`<font color=DarkBlue>Test</font>`	DarkBlue	#00008B
`<font color=DarkCyan>`	`<font color=DarkCyan>Test</font>`	DarkCyan	#008B8B
`<font color=DarkGoldenRod>`	`<font color=DarkGoldenRod>Test</font>`	DarkGoldenRod	#B8860B
`<font color=DarkGray>`	`<font color=DarkGray>Test</font>`	DarkGray	#A9A9A9
`<font color=DarkGreen>`	`<font color=DarkGreen>Test</font>`	DarkGreen	#006400
`<font color=DarkKhaki>`	`<font color=DarkKhaki>Test</font>`	DarkKhaki	#BDB76B
`<font color=DarkMagenta>`	`<font color=DarkMagenta>Test</font>`	DarkMagenta	#8B008B
`<font color=DarkOliveGreen>`	`<font color=DarkOliveGreen>Test</font>`	DarkOliveGreen	#556B2F
`<font color=Darkorange>`	`<font color=Darkorange>Test</font>`	Darkorange	#FF8C00
`<font color=DarkOrchid>`	`<font color=DarkOrchid>Test</font>`	DarkOrchid	#9932CC
`<font color=DarkRed>`	`<font color=DarkRed>Test</font>`	DarkRed	#8B0000
`<font color=DarkSalmon>`	`<font color=DarkSalmon>Test</font>`	DarkSalmon	#E9967A
`<font color=DarkSeaGreen>`	`<font color=DarkSeaGreen>Test</font>`	DarkSeaGreen	#8FBC8F
`<font color=DarkSlateBlue>`	`<font color=DarkSlateBlue>Test</font>`	DarkSlateBlue	#483D8B
`<font color=DarkSlateGray>`	`<font color=DarkSlateGray>Test</font>`	DarkSlateGray	#2F4F4F
`<font color=DarkTurquoise>`	`<font color=DarkTurquoise>Test</font>`	DarkTurquoise	#00CED1
`<font color=DarkViolet>`	`<font color=DarkViolet>Test</font>`	DarkViolet	#9400D3
`<font color=DeepPink>`	`<font color=DeepPink>Test</font>`	DeepPink	#FF1493
`<font color=DeepSkyBlue>`	`<font color=DeepSkyBlue>Test</font>`	DeepSkyBlue	#00BFFF
`<font color=DimGray>`	`<font color=DimGray>Test</font>`	DimGray	#696969
`<font color=DodgerBlue>`	`<font color=DodgerBlue>Test</font>`	DodgerBlue	#1E90FF
`<font color=Feldspar>`	`<font color=Feldspar>Test</font>`	Feldspar	#D19275
`<font color=FireBrick>`	`<font color=FireBrick>Test</font>`	FireBrick	#B22222
`<font color=FloralWhite>`	`<font color=FloralWhite>Test</font>`	FloralWhite	#FFFAF0
`<font color=ForestGreen>`	`<font color=ForestGreen>Test</font>`	ForestGreen	#228B22
`<font color=Fuchsia>`	`<font color=Fuchsia>Test</font>`	Fuchsia	#FF00FF
`<font color=Gainsboro>`	`<font color=Gainsboro>Test</font>`	Gainsboro	#DCDCDC
`<font color=GhostWhite>`	`<font color=GhostWhite>Test</font>`	GhostWhite	#F8F8FF
`<font color=Gold>`	`<font color=Gold>Test</font>`	Gold	#FFD700
`<font color=GoldenRod>`	`<font color=GoldenRod>Test</font>`	GoldenRod	#DAA520
`<font color=Gray>`	`<font color=Gray>Test</font>`	Gray	#808080
`<font color=Green>`	`<font color=Green>Test</font>`	Green	#008000
`<font color=GreenYellow>`	`<font color=GreenYellow>Test</font>`	GreenYellow	#ADFF2F
`<font color=HoneyDew>`	`<font color=HoneyDew>Test</font>`	HoneyDew	#F0FFF0
`<font color=HotPink>`	`<font color=HotPink>Test</font>`	HotPink	#FF69B4
`<font color=IndianRed>`	`<font color=IndianRed>Test</font>`	IndianRed	#CD5C5C
`<font color=Indigo>`	`<font color=Indigo>Test</font>`	Indigo	#4B0082
`<font color=Ivory>`	`<font color=Ivory>Test</font>`	Ivory	#FFFFF0
`<font color=Khaki>`	`<font color=Khaki>Test</font>`	Khaki	#F0E68C
`<font color=Lavender>`	`<font color=Lavender>Test</font>`	Lavender	#E6E6FA
`<font color=LavenderBlush>`	`<font color=LavenderBlush>Test</font>`	LavenderBlush	#FFF0F5
`<font color=LawnGreen>`	`<font color=LawnGreen>Test</font>`	LawnGreen	#7CFC00
`<font color=LemonChiffon>`	`<font color=LemonChiffon>Test</font>`	LemonChiffon	#FFFACD
`<font color=LightBlue>`	`<font color=LightBlue>Test</font>`	LightBlue	#ADD8E6
`<font color=LightCoral>`	`<font color=LightCoral>Test</font>`	LightCoral	#F08080
`<font color=LightCyan>`	`<font color=LightCyan>Test</font>`	LightCyan	#E0FFFF
`<font color=LightGoldenRodYellow>`	`<font color=LightGoldenRodYellow>Test</font>`	LightGoldenRodYellow	#FAFAD2
`<font color=LightGrey>`	`<font color=LightGrey>Test</font>`	LightGrey	#D3D3D3
`<font color=LightGrey>`	`<font color=LightGrey>Test</font>`	LightGreen	#90EE90
`<font color=LightPink>`	`<font color=LightPink>Test</font>`	LightPink	#FFB6C1
`<font color=LightSalmon>`	`<font color=LightSalmon>Test</font>`	LightSalmon	#FFA07A
`<font color=LightSeaGreen>`	`<font color=LightSeaGreen>Test</font>`	LightSeaGreen	#20B2AA
`<font color=LightSkyBlue>`	`<font color=LightSkyBlue>Test</font>`	LightSkyBlue	#87CEFA
`<font color=LightSlateBlue>`	`<font color=LightSlateBlue>Test</font>`	LightSlateBlue	#8470FF
`<font color=LightSlateGray>`	`<font color=LightSlateGray>Test</font>`	LightSlateGray	#778899
`<font color=LightSteelBlue>`	`<font color=LightSteelBlue>Test</font>`	LightSteelBlue	#B0C4DE
`<font color=LightYellow>`	`<font color=LightYellow>Test</font>`	LightYellow	#FFFFE0
`<font color=Lime>`	`<font color=Lime>Test</font>`	Lime	#00FF00
`<font color=LimeGreen>`	`<font color=LimeGreen>Test</font>`	LimeGreen	#32CD32
`<font color=Linen>`	`<font color=Linen>Test</font>`	Linen	#FAF0E6
`<font color=Magenta>`	`<font color=Magenta>Test</font>`	Magenta	#FF00FF
`<font color=Maroon>`	`<font color=Maroon>Test</font>`	Maroon	#800000
`<font color=MediumAquaMarine>`	`<font color=MediumAquaMarine>Test</font>`	MediumAquaMarine	#66CDAA
`<font color=MediumBlue>`	`<font color=MediumBlue>Test</font>`	MediumBlue	#0000CD
`<font color=MediumOrchid>`	`<font color=MediumOrchid>Test</font>`	MediumOrchid	#BA55D3
`<font color=MediumPurple>`	`<font color=MediumPurple>Test</font>`	MediumPurple	#9370D8
`<font color=MediumSeaGreen>`	`<font color=MediumSeaGreen>Test</font>`	MediumSeaGreen	#3CB371
`<font color=MediumSlateBlue>`	`<font color=MediumSlateBlue>Test</font>`	MediumSlateBlue	#7B68EE
`<font color=MediumSpringGreen>`	`<font color=MediumSpringGreen>Test</font>`	MediumSpringGreen	#00FA9A
`<font color=MediumTurquoise>`	`<font color=MediumTurquoise>Test</font>`	MediumTurquoise	#48D1CC
`<font color=MediumVioletRed>`	`<font color=MediumVioletRed>Test</font>`	MediumVioletRed	#C71585
`<font color=MidnightBlue>`	`<font color=MidnightBlue>Test</font>`	MidnightBlue	#191970
`<font color=MintCream>`	`<font color=MintCream>Test</font>`	MintCream	#F5FFFA
`<font color=MistyRose>`	`<font color=MistyRose>Test</font>`	MistyRose	#FFE4E1
`<font color=Moccasin>`	`<font color=Moccasin>Test</font>`	Moccasin	#FFE4B5
`<font color=NavajoWhite>`	`<font color=NavajoWhite>Test</font>`	NavajoWhite	#FFDEAD
`<font color=Navy>`	`<font color=Navy>Test</font>`	Navy	#000080
`<font color=OldLace>`	`<font color=OldLace>Test</font>`	OldLace	#FDF5E6
`<font color=Olive>`	`<font color=Olive>Test</font>`	Olive	#808000
`<font color=OliveDrab>`	`<font color=OliveDrab>Test</font>`	OliveDrab	#6B8E23
`<font color=Orange>`	`<font color=Orange>Test</font>`	Orange	#FFA500
`<font color=OrangeRed>`	`<font color=OrangeRed>Test</font>`	OrangeRed	#FF4500
`<font color=Orchid>`	`<font color=Orchid>Test</font>`	Orchid	#DA70D6
`<font color=PaleGoldenRod>`	`<font color=PaleGoldenRod>Test</font>`	PaleGoldenRod	#EEE8AA
`<font color=PaleGreen>`	`<font color=PaleGreen>Test</font>`	PaleGreen	#98FB98
`<font color=PaleTurquoise>`	`<font color=PaleTurquoise>Test</font>`	PaleTurquoise	#AFEEEE
`<font color=PaleVioletRed>`	`<font color=PaleVioletRed>Test</font>`	PaleVioletRed	#D87093
`<font color=PapayaWhip>`	`<font color=PapayaWhip>Test</font>`	PapayaWhip	#FFEFD5
`<font color=PeachPuff>`	`<font color=PeachPuff>Test</font>`	PeachPuff	#FFDAB9
`<font color=Peru>`	`<font color=Peru>Test</font>`	Peru	#CD853F
`<font color=Pink>`	`<font color=Pink>Test</font>`	Pink	#FFC0CB
`<font color=Plum>`	`<font color=Plum>Test</font>`	Plum	#DDA0DD
`<font color=PowderBlue>`	`<font color=PowderBlue>Test</font>`	PowderBlue	#B0E0E6
`<font color=Purple>`	`<font color=Purple>Test</font>`	Purple	#800080
`<font color=Red>`	`<font color=Red>Test</font>`	Red	#FF0000
`<font color=RosyBrown>`	`<font color=RosyBrown>Test</font>`	RosyBrown	#BC8F8F
`<font color=RoyalBlue>`	`<font color=RoyalBlue>Test</font>`	RoyalBlue	#4169E1
`<font color=SaddleBrown>`	`<font color=SaddleBrown>Test</font>`	SaddleBrown	#8B4513
`<font color=Salmon>`	`<font color=Salmon>Test</font>`	Salmon	#FA8072
`<font color=SandyBrown>`	`<font color=SandyBrown>Test</font>`	SandyBrown	#F4A460
`<font color=SeaGreen>`	`<font color=SeaGreen>Test</font>`	SeaGreen	#2E8B57
`<font color=SeaShell>`	`<font color=SeaShell>Test</font>`	SeaShell	#FFF5EE
`<font color=Sienna>`	`<font color=Sienna>Test</font>`	Sienna	#A0522D
`<font color=Silver>`	`<font color=Silver>Test</font>`	Silver	#C0C0C0
`<font color=SkyBlue>`	`<font color=SkyBlue>Test</font>`	SkyBlue	#87CEEB
`<font color=SlateBlue>`	`<font color=SlateBlue>Test</font>`	SlateBlue	#6A5ACD
`<font color=SlateGray>`	`<font color=SlateGray>Test</font>`	SlateGray	#708090
`<font color=Snow>`	`<font color=Snow>Test</font>`	Snow	#FFFAFA
`<font color=SpringGreen>`	`<font color=SpringGreen>Test</font>`	SpringGreen	#00FF7F
`<font color=SteelBlue>`	`<font color=SteelBlue>Test</font>`	SteelBlue	#4682B4
`<font color=Tan>`	`<font color=Tan>Test</font>`	Tan	#D2B48C
`<font color=Teal>`	`<font color=Teal>Test</font>`	Teal	#008080
`<font color=Thistle>`	`<font color=Thistle>Test</font>`	Thistle	#D8BFD8
`<font color=Tomato>`	`<font color=Tomato>Test</font>`	Tomato	#FF6347
`<font color=Turquoise>`	`<font color=Turquoise>Test</font>`	Turquoise	#40E0D0
`<font color=Violet>`	`<font color=Violet>Test</font>`	Violet	#EE82EE
`<font color=VioletRed>`	`<font color=VioletRed>Test</font>`	VioletRed	#D02090
`<font color=Wheat>`	`<font color=Wheat>Test</font>`	Wheat	#F5DEB3
`<font color=White>`	`<font color=White>Test</font>`	White	#FFFFFF
`<font color=WhiteSmoke>`	`<font color=WhiteSmoke>Test</font>`	WhiteSmoke	#F5F5F5
`<font color=Yellow>`	`<font color=Yellow>Test</font>`	Yellow	#FFFF00
`<font color=YellowGreen>`	`<font color=YellowGreen>Test</font>`	YellowGreen	#9ACD32

你认为这篇文章怎么样？

昵称

邮箱

网址

按正序
按倒序
按热度

强大的文档书写语言-Markdown

预览: