Markdown 语法入门指南



Markdown 是一种轻量级标记语言,让你用纯文本编写格式化的文档。它语法简洁、易学易用,广泛应用于笔记、博客、文档写作等场景。下面从零开始,带你快速掌握 Markdown 的核心语法。

■ 标题

使用 # 号表示标题,1~6 个 # 分别对应一级到六级标题,# 与文字之间需要加一个空格。
引用内容 引用内容
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

建议:一篇文章只使用一个一级标题,其余用二级及以下标题组织内容层次。

■ 文本样式

Markdown 支持多种文本强调方式:
引用内容 引用内容
加粗    **文字** 或 __文字__
斜体     *文字* 或 _文字_
删除线 ~~文字~~

说明:可以组合使用,比如 ***加粗斜体*** 可以同时加粗并倾斜。

■ 代码

行内代码:用反引号包裹代码片段
引用内容 引用内容
使用 `console.log()` 可以在控制台输出信息。

代码块:用三个反引号包裹多行代码,并可指定语言实现语法高亮
引用内容 引用内容
```python
def hello():
    print("Hello, World!")

```

说明:常见的语言标识有:python、javascript、java、html、css、bash 等。

■ 引用

使用 > 表示引用,可以嵌套使用:
引用内容 引用内容
> 这是一段引用文字。
>
> > 这是嵌套引用。

说明:引用块内也可以使用其他 Markdown 语法,如加粗、列表等。

■ 链接和图片

链接:
引用内容 引用内容
[链接文本](链接地址)
[链接文本](链接地址 "鼠标悬停提示")

图片:
引用内容 引用内容
![替代文字](图片地址)

■ 表格

用 | 分隔列,用 - 分隔表头和内容,用 : 控制对齐方式:
引用内容 引用内容
| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:-------:|-------:|
| 内容1  | 内容2   | 内容3  |
| 内容4  | 内容5   | 内容6  |

说明:表格的对齐符号 - 至少需要 3 个,: 的位置决定对齐方向。

■ 任务列表(复选框)

使用 - [ ] 表示未完成,- [x] 表示已完成:
引用内容 引用内容
- [x] 学习 Markdown 基本语法
- [x] 练习标题和列表
- [ ] 掌握表格和代码块
- [ ] 写一篇完整的 Markdown 文档

■ 列表

无序列表:使用 -、* 或 + 作为列表标记
引用内容 引用内容
- 苹果
- 香蕉
- 橙子

有序列表:使用数字加英文句点
引用内容 引用内容
1. 第一步:打开编辑器
2. 第二步:编写内容
3. 第三步:保存文件

嵌套列表:在子项前添加缩进(2 个或 4 个空格)即可实现嵌套
引用内容 引用内容
- 水果
  - 苹果
  - 香蕉
- 蔬菜
  - 西红柿
  - 黄瓜

■ 分割线

使用三个或以上的 -、* 或 _(单独一行)来创建分割线:
引用内容 引用内容
---

■ 转义字符

如果你想显示 Markdown 中的特殊符号本身,可以在前面加反斜杠 \ 进行转义:
引用内容 引用内容
\*这不是斜体\*
\# 这不是标题

■ HTML 混用

Markdown 兼容 HTML 标签,当 Markdown 语法无法满足需求时,可以直接使用 HTML:
引用内容 引用内容
这是普通文字。<br>这是换行后的文字。

Markdown 文件通常以 .md 或 .markdown 为后缀,掌握了以上语法,已经能够应对绝大多数的 Markdown 写作场景了。Markdown 的魅力在于:专注于内容本身,而不是排版格式。

评论: 0 | 引用: 0 | 查看次数: 10
发表评论
登录后再发表评论!