在当今的数字写作中,Markdown已经成为一种非常流行和实用的轻量级标记语言。它语法简洁、易于学习,能够让你专注于内容创作,同时轻松地生成结构清晰、格式美观的文档。无论是撰写博客、编写技术文档、做笔记,还是在GitHub等平台上进行协作,Markdown都扮演着重要角色。

本文将带你快速掌握Markdown的基础语法,助你轻松上手。


什么是Markdown?

Markdown由John Gruber于2004年创建,其设计初衷是让纯文本内容具备可读性的同时,通过简单的符号标记来实现格式化,最终可转换为结构化的HTML(超文本标记语言)。

它的核心理念是:“写起来简单,读起来清晰”


基础语法详解

1. 标题(Headings)

使用 # 符号来创建标题,# 的数量代表标题的层级(从H1到H6)。

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

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2. 段落与换行

段落之间通过空行分隔。
在同一段落中想要换行,可以在行尾添加两个或以上空格,或直接另起一行并空行。

这是第一段。   

这是第二段。

3. 强调文本(粗体、斜体)

  • 粗体:使用双星号 ** 或双下划线 __
  • 斜体:使用单星号 * 或单下划线 _
  • 粗斜体:使用三颗星号 ***
**这是粗体文字**
*这是斜体文字*
***这是粗斜体文字***

效果:
这是粗体文字
这是斜体文字
这是粗斜体文字


4. 列表

无序列表(项目符号)

使用 -*+ 开头:

- 项目一
- 项目二
  - 子项目(通过缩进创建)

有序列表(编号)

使用数字加点:

1. 第一项
2. 第二项
3. 第三项

效果:

  • 项目一
  • 项目二
    • 子项目
  1. 第一项
  2. 第二项
  3. 第三项

5. 链接与图片

链接

语法:[链接文字](URL)

[访问小希的网站](https://smallxi.cn)

效果:
访问小希的网站

图片

语法:![替代文字](图片URL)

![一张图片](https://vip.123pan.cn/1843810803/21601135)

效果:
一张图片

注:! 表示这是一个图片,[] 中是图片无法显示时的替代文字。


6. 引用

使用 > 表示引用内容,常用于引用他人话语或强调文本。

> 这是一段引用文字。
>
> 可以跨多行。

效果:

这是一段引用文字。

可以跨多行。


7. 代码

行内代码

使用反引号 ` 包裹:

使用 `console.log()` 输出信息。

效果: 使用 console.log() 输出信息。

代码块

使用三个反引号 ``` 包围,可指定语言类型(如 jspython 等)实现语法高亮:

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

效果:

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

8. 分隔线

使用三个或以上的 ---***___ 创建水平分隔线。

---

效果:



9. 表格(扩展语法)

虽然原始Markdown不支持表格,但大多数现代解析器(如GitHub)都支持。

| 姓名 | 年龄 | 职业     |
|------|------|----------|
| 张三 | 25   | 工程师   |
| 李四 | 30   | 设计师   |

效果:

姓名年龄职业
张三25工程师
李四30设计师

实用小贴士

  • 保持简洁:Markdown的魅力在于简洁,避免过度使用格式。
  • 预览功能:大多数编辑器(如Typora、VS Code)都支持实时预览,帮助你即时查看效果。
  • 兼容性:不同平台对Markdown的扩展支持略有差异(如表格、任务列表),建议根据使用场景查阅具体文档。

总结

Markdown是一种高效、优雅的写作工具。通过本文介绍的基础语法,你已经可以开始使用Markdown来撰写结构清晰、格式规范的文档了。随着实践的深入,你还可以学习更多高级功能,如任务列表、数学公式(LaTeX)、流程图等。

现在,就打开一个支持Markdown的编辑器,开始你的第一篇Markdown文档吧!