返回

Markdown 文档编辑语法

Pearls of silky soft white cotton, bubble up under vibrant lighting

学习一种简洁的文档书写方式。

初见 Markdown

Markdown 是一种轻量级标记语言

  • Markdown 是一种轻量级标记语言,创始人为约翰·格鲁伯(John Gruber)。
  • Markdown 允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML 文档。
  • Markdown 编写的文档可以导出 HTML 、Word、图像、PDF、Epub 等多种格式的文档。
  • Markdown 编写的文档后缀为 .md

基本语法

这些是 John Gruber 的原始设计文档中列出的元素。
所有 Markdown 应用程序都支持这些元素。

元素Markdown 语法表现
标题(Heading)# H1
## H2
#### H4
##### H5
###### H6
粗体(Bold)**bold text**bold text
斜体(Italic)_italicized text_italicized text
引用块(Blockquote)> blockquote
有序列表(Ordered List)1. First item
2. Second item
3. Third item
无序列表(Unordered List)- First item
- Second item
- Third item
代码(Code)`code`code
分隔线(Horizontal Rule)---
链接(Link)[title](https://www.example.com)title
图片(Image)![alt text](image.jpg)

Markdown 标题语法细节/技巧

标题

  • 使用#号标记,可以表示 1-6 级标题, 随#的个数递增,一级标题字号最大,六级标题字号最小。
  • 最后一个#字符与标题中间留一个空格
  • 标题应该置于行首,如果放入表格中可能无法正确解析

字体

星号与下划线都可以。

  • 单是斜体,
  • 双是粗体,
  • 三是粗斜体

换行

Markdown 换行的方式有很多种:

  • 直接在一句话后敲两个空格
  • 两句话之间加一个空行
  • 如果你在编辑的时候,想让一行文字在显示的时候换行,就在中间加<br/>

引用

Markdown 中引用通过符号 > 来实现。

  • > 符号后的空格,可有可无。
  • 在引用的区块内,允许换行存在,换行并不会终止引用的区块。
  • 如果要结束引用,需要一行空白行,来结束引用的区块。
  • 引用还可以嵌套使用。

列表

列表分为有序列表和无序列表无序列表

  • 使用*、+、-,再加一个空格作为列表的标记;
  • 有序列表,使用数字并加上.号,再加一个空格作为列表的标记。
  • 如果想要控制列表的层级,则需要在列表符号前使用Tab

分割线

Markdown中给出了多种分割线的样式,我们可以使用分割线让文章结构更加的清晰。

  • 分割线的使用,可以在一行中用三个-or*来建立一个分割线,
  • 但是注意:在分割线的上面空一行!!!否则会导致前一行字体放大。
最新修改时间:2025-08-30 21:40