风格指南 #

概述 #

风格指南帮助你编写一致、规范的 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
推荐:
![用户登录界面截图](login.png)

不推荐:
![图片](login.png)

图片尺寸 #

markdown
推荐:
<img src="image.png" width="600">

不推荐:
![图片](image.png)(无尺寸控制)

表格规范 #

对齐方式 #

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 #

https://www.markdownguide.org

GitHub 文档风格 #

https://docs.github.com/en/contributing

恭喜完成! #

你已经完成了 Markdown 完全指南的学习!

学习回顾 #

  1. 入门基础 - 标题、段落、强调
  2. 列表语法 - 有序、无序、任务列表
  3. 链接图片 - 链接、图片语法
  4. 代码引用 - 代码块、引用语法
  5. 表格分割 - 表格、分割线
  6. 扩展语法 - 删除线、脚注等
  7. 高级技巧 - HTML、公式、图表
  8. 实战应用 - 技术文档、README
  9. 工具资源 - 编辑器、在线工具
  10. 最佳实践 - 格式规范、风格指南

下一步建议 #

  1. 多加练习,巩固所学
  2. 在实际项目中应用
  3. 形成自己的写作风格
  4. 持续学习新的扩展语法

祝你写作愉快!

最后更新:2026-03-24