Markdown 写作语法

2024-12-08 · 工具

整理一份自己日常写笔记常用的 Markdown 语法。重点是好记好查,不追求覆盖全部扩展语法。

标题

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

一般用到三级就够了,太深的层级反而读起来累。

强调

*斜体* 或 _斜体_
**加粗** 或 __加粗__
~~删除线~~

列表

- 无序项一
- 无序项二
  - 嵌套子项

1. 有序项一
2. 有序项二

嵌套时用两个空格缩进,不同编辑器对 Tab 的处理略有差异,用空格最稳。

链接和图片

[链接文字](https://example.com)
![图片描述](path/to/image.png)

代码

行内代码用反引号:`code`。代码块用三个反引号:

```python
print("Hello")
```

引用

> 这是一段引用
> 可以多行

分割线

---  或  ***

表格

| 列一 | 列二 |
| --- | --- |
| A | B |
| C | D |

对齐方式可以在分隔行用 :---(左)、:---:(居中)、---:(右)。

任务清单(扩展)

- [x] 已完成
- [ ] 未完成

常用心得

  • 用单空格段落分隔不一定换行,中间留一空行最稳。
  • 中文标点和 Markdown 符号之间最好加一个空格,渲染更好看。
  • 插入 HTML 也是允许的,但写多了就失去 Markdown 的简洁感了。
  • 预览时常用 VSCode 自带的 Markdown Preview,所见即所得。

小结

Markdown 的核心价值是把"写作"和"格式"解耦——专注写内容,排版让渲染器去做。十来种语法基本够覆盖日常笔记、README、博客的所有需求。

← 返回笔记列表