1330 字
7 分钟
正在加载...
Markdown 基础语法指南

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档。本文将详细介绍 Markdown 的基础语法,帮助初学者快速掌握这个强大的文档编写工具。

什么是 Markdown?#

Markdown 由 John Gruber 在 2004 年创建,目标是让人们能够使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML。它的语法简洁明了,学习成本低,被广泛应用于:

  • 技术文档编写
  • 博客文章
  • README 文件
  • 在线论坛
  • 笔记应用

基础语法#

标题语法#

Markdown 支持六级标题,使用 # 符号表示:

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

效果展示:

一级标题#

二级标题#

三级标题#

四级标题#

五级标题#
六级标题#

文本格式#

基础文本样式#

语法效果说明
**粗体文本**粗体文本使用两个星号包围
*斜体文本*斜体文本使用一个星号包围
***粗斜体***粗斜体使用三个星号包围
~~删除线~~删除线使用两个波浪号包围

替代语法#

你也可以使用下划线来表示强调:

__粗体文本__
_斜体文本_
___粗斜体___

段落和换行#

  • 段落:段落之间用空行分隔
  • 换行:行末加两个空格,或使用 <br> 标签
这是第一段文字。
这是第二段文字。
这是同一段的第一行。
这是同一段的第二行。

链接语法#

行内链接#

[链接文本](https://example.com)
[带标题的链接](https://example.com "这是标题")

效果:

引用式链接#

[链接文本][1]
[另一个链接][link-ref]
[1]: https://example.com
[link-ref]: https://example.com "可选标题"

自动链接#

<https://example.com>
<email@example.com>

效果:

图片语法#

行内图片#

![替代文本](图片URL)
![替代文本](图片URL "可选标题")

引用式图片#

![替代文本][image-ref]
[image-ref]: 图片URL "可选标题"

列表语法#

无序列表#

使用 -*+ 创建无序列表:

- 项目一
- 项目二
- 子项目 2.1
- 子项目 2.2
- 项目三

效果:

  • 项目一
  • 项目二
    • 子项目 2.1
    • 子项目 2.2
  • 项目三

有序列表#

使用数字加点创建有序列表:

1. 第一项
2. 第二项
1. 子项目 2.1
2. 子项目 2.2
3. 第三项

效果:

  1. 第一项
  2. 第二项
    1. 子项目 2.1
    2. 子项目 2.2
  3. 第三项

任务列表#

- [x] 已完成任务
- [ ] 未完成任务
- [x] 另一个已完成任务

效果:

  • 已完成任务
  • 未完成任务
  • 另一个已完成任务

引用语法#

使用 > 创建引用:

> 这是一个引用
>
> 可以包含多个段落
>
> > 这是嵌套引用

效果:

这是一个引用

可以包含多个段落

这是嵌套引用

代码语法#

行内代码#

使用反引号包围:

这是 `行内代码` 示例

效果:这是 行内代码 示例

代码块#

使用三个反引号创建代码块:

```
这是一个代码块
可以包含多行代码
```

指定语言的代码块#

```javascript
function hello() {
console.log("Hello World!");
}
```

效果:

function hello() {
console.log("Hello World!");
}

分隔线#

使用三个或更多的连字符、星号或下划线:

---
***
___

效果:


表格语法#

| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:--------:|-------:|
| 内容1 | 内容2 | 内容3 |
| 长内容 | 短内容 | 中等 |

效果:

左对齐居中对齐右对齐
内容1内容2内容3
长内容短内容中等

转义字符#

当你需要显示 Markdown 语法字符本身时,可以使用反斜杠进行转义:

字符转义语法效果
*\**
_\__
#\##
+\++
-\--
.\..
!\!!
[\[[
]\]]
(\((
)\))

实用技巧#

1. 换行技巧#

  • 段落分隔:段落间空一行
  • 强制换行:行末加两个空格
  • HTML换行:使用 <br> 标签

2. 空格技巧#

  • &nbsp; - 不间断空格
  • &ensp; - 半角空格
  • &emsp; - 全角空格

3. 特殊符号#

描述语法效果
版权符号&copy;©
注册商标&reg;®
商标符号&trade;
左箭头&larr;
右箭头&rarr;

4. 键盘按键#

按 <kbd>Ctrl</kbd> + <kbd>C</kbd> 复制

效果:按 Ctrl + C 复制

最佳实践#

1. 文档结构#

  • 使用标题创建清晰的文档结构
  • 合理使用列表组织信息
  • 适当使用引用突出重要内容

2. 可读性#

  • 在标题和内容之间留空行
  • 使用一致的列表符号
  • 保持代码块的语言标识

3. 兼容性#

  • 避免使用过于复杂的嵌套结构
  • 测试在不同平台上的显示效果
  • 使用标准语法确保兼容性

总结#

Markdown 的基础语法简单易学,掌握了这些语法,你就可以:

  1. 快速编写格式化文档
  2. 专注内容而不是格式
  3. 跨平台兼容,在各种编辑器中使用
  4. 版本控制友好,便于协作开发
  5. 易于转换为 HTML、PDF 等格式

这些基础语法是所有 Markdown 编辑器都支持的标准语法。掌握了基础语法后,你可以进一步学习各种扩展语法和高级功能。


希望这份 Markdown 基础语法指南对你有帮助!如果你想了解更多高级功能,可以查看我们的进阶语法指南。

Markdown 基础语法指南
https://www.shimoxi.qzz.io/2025/07/14/18/
作者
石墨烯积木
发布于
2025-07-14
许可协议
CC BY-NC-SA 4.0

评论

正在加载评论系统...