技术分享

Markdown 基本语法 | Markdown 教程

作者：rpflyfox · · 0℃ · 0条评论

从零开始:Markdown 基础语法完全攻略

一、场景引入:告别 Word 排版焦虑

你是否经历过这样的困扰?写完一篇文章,兴冲冲地要分享给别人,结果发过去发现格式全乱——标题大小不一、列表错位、代码段落变成天书。或者在 GitHub 提交文档、在简书写文章时,折腾半天排版,真正写内容的时间却被挤压。

Markdown 正是为了解决这些痛点而生。它让你用纯粹的文本符号完成文档排版,无需鼠标点击,只需键盘就能快速完成标题、列表、引用、代码块的格式设置,把精力集中在内容本身。

二、工具介绍:轻量高效的文本格式

Markdown 是一种轻量级标记语言,使用简单的符号即可完成格式化操作。主流平台如 GitHub、Wikipedia、知乎、简书等都原生支持 Markdown。你只需要一个文本编辑器(如 VS Code、Typora)或在线编辑器,就能开始使用。

三、核心语法速成

1. 标题语法

在文字前加 1-6 个 # 号,数量代表标题层级:

# 一级标题
## 二级标题
### 三级标题

2. 段落与换行

普通文本自然分段即可。如需强制换行,在行末加两个空格后回车,或直接空一行分段。

3. 强调语法

  • 斜体:用 *文字* 或 _文字_ 包裹
  • 粗体:用 **文字** 或 __文字__ 包裹
  • 删除线:用 ~~文字~~ 包裹

4. 引用块语法

在文字前加 > 符号,可嵌套多层:

> 这是一级引用
>> 这是二级引用

5. 列表语法

  • 无序列表:使用 -、+ 或 * 开头
  • 有序列表:使用数字加点,如 1. 2.
  • 任务列表(部分平台支持):- [ ] 未勾选,- [x] 已勾选

6. 代码语法

  • 行内代码:用反引号 `代码` 包裹
  • 代码块:用三个反引号 ``` 包裹,可指定语言:
```javascript
console.log("Hello World")


### 7. 链接与图片
- **链接**:`[显示文字](链接地址)`
- **图片**:`![替代文字](图片地址)`

### 8. 分隔线
输入三个及以上 `*` 或 `-` 可生成水平分割线:

“`

9. 转义字符

在特殊符号前加反斜杠 \ 可使其变为普通字符,如 \* 会显示为 * 而非强调符号。

四、实用技巧与快捷键

功能 快捷键
粗体 Ctrl + B
斜体 Ctrl + I
插入链接 Ctrl + K
插入图片 Ctrl + Shift + I
插入代码块 Ctrl + Shift + K

提示:使用 Typora 等所见即所得编辑器时,光标选中文字后直接按快捷键即可,无需手动输入符号。

五、常见问题与解决方案

问题1:特殊符号显示错误
原因:符号前后缺少空格或包裹不规范。
解决:检查语法格式,确保符号成对出现,前后留有空格(链接和图片除外)。

问题2:代码块无法高亮
原因:未指定语言或语言名称拼写错误。
解决:在第一个 后加上语言标识,如 ````python ““。

问题3:换行不生效
原因:行尾未加两个空格。
解决:在需要换行的位置行尾加两个空格再回车。

六、拓展推荐

  • 在线编辑器:markdown.com.cn、stackedit.io
  • 桌面编辑器:Typora(付费但体验极佳)、Obsidian(知识库管理)
  • 进阶玩法:学习 HTML 混编,实现更复杂的排版效果;掌握 Git 配合 Markdown 进行版本管理;了解 Pandoc 实现多格式文档转换。

掌握 Markdown 基本语法,只需不到半小时。从此告别排版烦恼,让你的表达更优雅、更高效。

参考资料:原文链接

Views: 4