风格指南 #
概述 #
风格指南帮助你编写一致、规范的 Markdown 文档。
命名规范 #
文件命名 #
markdown
推荐:
getting-started.md
api-reference.md
configuration.md
不推荐:
Getting Started.md
API Reference.md
图片命名 #
markdown
推荐:
user-login-screenshot.png
system-architecture-diagram.png
不推荐:
1.png
image.png
标题规范 #
标题格式 #
markdown
推荐:
## Getting Started
## API Reference
不推荐:
## Getting started
## api reference
标题层级 #
markdown
推荐:
# 文档标题
## 章节
### 小节
不推荐:
# 文档标题
### 直接跳到小节
列表规范 #
无序列表 #
markdown
推荐:
- 项目一
- 项目二
- 项目三
不推荐:
* 项目一
+ 项目二
- 项目三
有序列表 #
markdown
推荐:
1. 项目一
1. 项目二
1. 项目三
不推荐:
1. 项目一
2. 项目二
3. 项目三
代码规范 #
代码块 #
markdown
推荐:
```javascript
const greeting = 'Hello, World!';
不推荐:
text
const greeting = 'Hello, World!';
text
### 行内代码
```markdown
推荐:
使用 `npm install` 安装依赖
不推荐:
使用 npm install 安装依赖
链接规范 #
链接文本 #
markdown
推荐:
查看 [官方文档](https://example.com)
不推荐:
点击 [这里](https://example.com)
引用链接 #
markdown
推荐:
[GitHub][gh]
[gh]: https://github.com
不推荐:
[GitHub](https://github.com)
图片规范 #
替代文本 #
markdown
推荐:

不推荐:

图片尺寸 #
markdown
推荐:
<img src="image.png" width="600">
不推荐:
(无尺寸控制)
表格规范 #
对齐方式 #
markdown
推荐:
| 名称 | 数量 |
|:------|-----:|
| A | 100 |
不推荐:
| 名称 | 数量 |
|-------|-------|
| A | 100 |
表格简洁 #
markdown
推荐:
简单表格
不推荐:
过于复杂的表格
空白规范 #
空行 #
markdown
推荐:
段落一
段落二
不推荐:
段落一
段落二
行尾 #
markdown
推荐:
内容(无行尾空格)
不推荐:
内容(有行尾空格)
强调规范 #
粗体 #
markdown
推荐:
**重要内容**
不推荐:
__重要内容__
斜体 #
markdown
推荐:
*强调内容*
不推荐:
_强调内容_
引用规范 #
markdown
推荐:
> 引用内容
不推荐:
>引用内容(无空格)
分割线规范 #
markdown
推荐:
---
不推荐:
***
___
风格检查工具 #
Markdownlint #
json
{
"default": true,
"MD003": { "style": "atx" },
"MD004": { "style": "dash" },
"MD007": { "indent": 2 },
"MD013": false,
"MD033": false
}
Prettier #
json
{
"proseWrap": "always",
"tabWidth": 2,
"useTabs": false
}
风格指南参考 #
Google Markdown 风格指南 #
https://google.github.io/styleguide/docguide/style.html
Markdown Guide #
GitHub 文档风格 #
https://docs.github.com/en/contributing
恭喜完成! #
你已经完成了 Markdown 完全指南的学习!
学习回顾 #
- 入门基础 - 标题、段落、强调
- 列表语法 - 有序、无序、任务列表
- 链接图片 - 链接、图片语法
- 代码引用 - 代码块、引用语法
- 表格分割 - 表格、分割线
- 扩展语法 - 删除线、脚注等
- 高级技巧 - HTML、公式、图表
- 实战应用 - 技术文档、README
- 工具资源 - 编辑器、在线工具
- 最佳实践 - 格式规范、风格指南
下一步建议 #
- 多加练习,巩固所学
- 在实际项目中应用
- 形成自己的写作风格
- 持续学习新的扩展语法
祝你写作愉快!
最后更新:2026-03-24