Markdown语法基础使用教程
在当今的数字写作中,Markdown已经成为一种非常流行和实用的轻量级标记语言。它语法简洁、易于学习,能够让你专注于内容创作,同时轻松地生成结构清晰、格式美观的文档。无论是撰写博客、编写技术文档、做笔记,还是在GitHub等平台上进行协作,Markdown都扮演着重要角色。
本文将带你快速掌握Markdown的基础语法,助你轻松上手。
什么是Markdown?
Markdown由John Gruber于2004年创建,其设计初衷是让纯文本内容具备可读性的同时,通过简单的符号标记来实现格式化,最终可转换为结构化的HTML(超文本标记语言)。
它的核心理念是:“写起来简单,读起来清晰”。
基础语法详解
1. 标题(Headings)
使用 #
符号来创建标题,#
的数量代表标题的层级(从H1到H6)。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
效果:
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2. 段落与换行
段落之间通过空行分隔。
在同一段落中想要换行,可以在行尾添加两个或以上空格,或直接另起一行并空行。
这是第一段。
这是第二段。
3. 强调文本(粗体、斜体)
- 粗体:使用双星号
**
或双下划线__
- 斜体:使用单星号
*
或单下划线_
- 粗斜体:使用三颗星号
***
**这是粗体文字**
*这是斜体文字*
***这是粗斜体文字***
效果:
这是粗体文字
这是斜体文字
这是粗斜体文字
4. 列表
无序列表(项目符号)
使用 -
、*
或 +
开头:
- 项目一
- 项目二
- 子项目(通过缩进创建)
有序列表(编号)
使用数字加点:
1. 第一项
2. 第二项
3. 第三项
效果:
- 项目一
- 项目二
- 子项目
- 第一项
- 第二项
- 第三项
5. 链接与图片
链接
语法:[链接文字](URL)
[访问小希的网站](https://smallxi.cn)
效果:
访问小希的网站
图片
语法:

效果:
注:
!
表示这是一个图片,[]
中是图片无法显示时的替代文字。
6. 引用
使用 >
表示引用内容,常用于引用他人话语或强调文本。
> 这是一段引用文字。
>
> 可以跨多行。
效果:
这是一段引用文字。
可以跨多行。
7. 代码
行内代码
使用反引号 `
包裹:
使用 `console.log()` 输出信息。
效果: 使用 console.log()
输出信息。
代码块
使用三个反引号 ```
包围,可指定语言类型(如 js
、python
等)实现语法高亮:
```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文档吧!