Markdown 写作入门教程

Markdown 是一种"用符号标记格式"的纯文本语言，是写博客、README、文档的通用标准——你现在看到的这篇文章就是用 Markdown 写的。学会它只需 15 分钟，却能用一辈子。

一、标题与段落

用 # 表示标题，几个井号就是几级标题（建议一篇文章只有一个一级标题）：

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

正文直接写即可，段落之间空一行。行尾加两个空格再回车，或在两行间留空行，才会换行显示。

二、文字格式

**加粗**
*斜体*
~~删除线~~
`行内代码`

效果：加粗、斜体、删除线、行内代码。

三、列表

- 无序列表项
- 另一项
  - 缩进两个空格是子项

1. 有序列表
2. 自动编号

四、链接与图片

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

图片就是链接前面多个 !。写教程时建议图片用相对路径存放在仓库里。

五、代码块

三个反引号包裹，并标注语言以获得高亮：

```bash
echo "hello"
```

这是技术文章最重要的语法，没有之一。

六、表格

| 命令 | 作用 |
| --- | --- |
| `ls` | 列出文件 |
| `pwd` | 当前目录 |

七、引用与分割线

> 这是一段引用，常用来放提示或警告。

---

这是一段引用。配合 ⚠️ 符号可以作为教程中的"注意"区块。

八、写作习惯建议

• 标题层级只往下走，不跳级：# 后面直接 ### 是坏味道

• 命令、文件名、快捷键一律用行内代码 ` 包起来

• 长文章多用 --- 分割线和二级标题分块

• 需要精确排版再学 HTML 标签——Markdown 完全兼容内嵌 HTML

九、在哪写 Markdown

• 编辑器：VS Code（自带预览，Ctrl+Shift+V）、Obsidian（双链笔记）

• 在线：GitHub 网页编辑、各种博客后台

• 导出：Pandoc 可把 Markdown 转成 Word/PDF/HTML

十、总结

Markdown 的设计哲学是"纯文本优先"——不用任何特定软件也能读、能改、能进版本控制。这也是为什么它成了程序员的通用书写语言。