一级标题 <!-- MD018: 和文字之间需要空格 -->

二级标题

【免费下载链接】typora_plugin Typora plugin. feature enhancement tool | Typora 插件，功能增强工具 项目地址: https://gitcode.com/gh_mirrors/ty/typora_plugin

###三级标题

**修复方案：**
```markdown
# 一级标题    <!-- 正确 -->
## 二级标题   <!-- 正确 -->
### 三级标题  <!-- 正确 -->

2. 列表格式问题（MD004-007, MD029-030）

问题示例：

- 项目1
  - 子项目1    <!-- MD005: 缩进不一致 -->
  * 子项目2    <!-- MD004: 列表符号不一致 -->
1. 第一项
3. 第三项     <!-- MD029: 序号不连续 -->

修复方案：

- 项目1
  - 子项目1    <!-- 正确 -->
  - 子项目2    <!-- 正确 -->
1. 第一项
2. 第二项     <!-- 正确 -->

3. 代码块问题（MD031, MD040）

问题示例：

这是一个段落
```python
print("hello")   <!-- MD031: 代码块需要空行分隔 -->

继续段落

console.log("hello")

**修复方案：**
```markdown
这是一个段落

```python
print("hello")   <!-- 正确 -->

继续段落

console.log("hello")   <!-- 正确 -->

### 4. 链接相关问题（MD011, MD034, MD042）

**问题示例：**
```markdown
[示例链接](example.com)   <!-- MD034: 裸链接需要尖括号 -->
[空链接]()               <!-- MD042: 链接地址不能为空 -->
](错误括号位置)          <!-- MD011: 括号位置错误 -->

修复方案：

[示例链接](<example.com>)   <!-- 正确 -->
[有效链接](https://example.com)   <!-- 正确 -->
[正确括号](位置正确)       <!-- 正确 -->

高级配置技巧

自定义规则文件

创建自定义规则配置文件 custom_rules.json：

{
  "extends": "markdownlint/style/prettier",
  "rules": {
    "MD013": {
      "line_length": 120,
      "code_blocks": false,
      "tables": false
    },
    "MD007": { "indent": 4 },
    "MD029": { "style": "one" },
    "MD040": false
  }
}

在插件配置中引用：

[markdownLint]
rule_config = { "extends": "./custom_rules.json" }
custom_rules_files = ["./custom_rules.json"]

按项目配置规则

不同项目可能需要不同的格式要求：

# 技术文档项目
[markdownLint.rule_config]
MD013.line_length = 100
MD040.language_only = true
MD044.names = ["JavaScript", "TypeScript", "React"]

# 学术论文项目  
[markdownLint.rule_config]
MD013.line_length = 80
MD025.level = 2
MD036.punctuation = ".,:!?。，；：！？"

忽略特定文件或内容

使用HTML注释临时禁用规则：

【免费下载链接】typora_plugin Typora plugin. feature enhancement tool | Typora 插件，功能增强工具 项目地址: https://gitcode.com/gh_mirrors/ty/typora_plugin