Markdown

轻量标记语言:五组常用语法、为什么适合写技术笔记、三个常见坑。

被 22 篇文章引用写作577 字2026-10-12全部知识点

Markdown#

Markdown 是一门轻量标记语言 —— 用纯文本表达结构(标题、列表、链接、代码块)。

设计目标是「可读性优先」:没渲染时也是一份能直接读的纯文本。

1. 最常用的五组语法#

# 一级标题
## 二级标题
**粗体** *斜体* `行内代码`
- 无序列表
1. 有序列表
> 引用块
[链接](https://example.com) ![图片](./img.png)

代码块:

const x = 1;

2. 为什么它适合写技术笔记#

· 纯文本:能进 Git、能被 diff、任何编辑器都能打开; · 与代码同源:代码块直接写,不需要切格式; · 到处都能渲染:博客、README、issue、聊天工具都支持。

3. 常见坑#

· 空行很重要:段落之间必须有空行,否则会被当成同一段; · 不要混用标记:同一份文档里别一会儿 * 一会儿 _(不同解析器处理不一致); · 表格分隔行必需:第二行的 |---|---| 不是装饰,缺了就不是表格。

参考:CommonMark 规范

引用了这个词条的文章