> ## Documentation Index
> Fetch the complete documentation index at: https://writer.wjstar.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 文章写作风格指南

> 基于 mp 目录下所有文章提炼的写作风格规范和最佳实践

# 文章写作风格指南

> 基于 mp 目录下所有文章深度分析，提炼出的系统性写作风格规范

## 一、标题设计原则

### 1.1 核心特征

* **简洁有力**：标题控制在15-25字之间，突出核心价值
* **具体承诺**：包含具体数字、时间或效果承诺
* **关键词突出**：标题中包含核心关键词，便于搜索和理解
* **情感色彩**：适当使用情感词汇增强吸引力

### 1.2 标题模板

```
[数字] + [核心主题] + [具体收益]
例如："3分钟教你用AI做出专业级音乐"

[疑问句] + [核心痛点] + [解决方案]
例如："为什么你的 ChatGPT 总给不出好答案？90%的人都在用错误的方式提问"

[热点词] + [产品/技术] + [核心价值]
例如："ChatGPT Atlas 重磅发布：OpenAI 的下一代 AI 工作平台"
```

### 1.3 标题要素分析

* **数字元素**：3分钟、90%、六阶段等具体数字增强可信度
* **时效性词汇**：重磅发布、最新、2024年等突出时效性
* **对比反差**：传统 vs 新式、错误 vs 正确等制造张力
* **承诺性表述**：教你、帮你、让你等直接承诺价值

## 二、开篇策略

### 2.1 黄金开场公式

```
场景引入 + 问题抛出 + 解决方案预告
```

### 2.2 开场方式类型

#### 提问式开场

```
你有没有过这样的经历？
对着 ChatGPT 输入一个问题，得到的却是千篇一律、模棱两可的官话套话。
```

#### 场景式开场

```
你知道吗？现在制作一首原创音乐只需要 3 分钟。
不需要学乐理，不需要会乐器，甚至不需要会唱歌。
```

#### 数据式开场

```
2024年10月，Anthropic悄然发布了一项可能改变AI助手生态的重要功能——Claude Code Skills。
```

#### 对比式开场

```
就在大家还在感叹 ChatGPT 改变世界的时候，OpenAI 悄然推出了更具革命性的产品——ChatGPT Atlas。
```

### 2.3 开场要素

* **制造共鸣**：让读者产生"说的就是我"的感觉
* **抛出痛点**：明确指出读者面临的问题
* **建立期待**：暗示解决方案的存在
* **情感调动**：使用感叹号、问号等标点增强情感

## 三、结构组织规范

### 3.1 整体架构

```
标题
├── 引言/概述
├── 核心内容（分章节）
│   ├── 第一部分
│   ├── 第二部分
│   └── 第三部分
├── 总结/行动建议
└── 补充信息（可选）
```

### 3.2 章节编号系统

* **中文数字**：`一、二、三`（适用于主要章节）
* **阿拉伯数字**：`1、2、3`（适用于要点列举）
* **英文编号**：`Part 1、Part 2`（适用于英文技术文章）

### 3.3 小标题设计原则

* **简短明确**：每个小标题不超过15字
* **动词开头**：使用动词开头，增强行动感
* **平行结构**：同一级别的标题保持结构一致
* **关键词突出**：标题中包含核心关键词

### 3.4 内容层次

```
一级标题：# 标题
二级标题：## 小标题
三级标题：### 要点
四级标题：#### 细节
```

## 四、语言表达风格

### 4.1 语调特征

* **口语化**：使用日常对话语调，避免过于正式的书面语
* **亲近感**：使用"你"、"我们"等第二人称，增强亲近感
* **互动性**：大量使用反问句，与读者进行对话
* **热情洋溢**：使用感叹句表达热情和感染力

### 4.2 句式特点

```
短句为主，长句为辅
疑问句 + 感叹句 + 叙述句组合使用
适当使用排比句增强气势
```

### 4.3 表达技巧

#### 对比反差

```
不是...而是...
传统方式 vs 新方式
错误做法 vs 正确做法
```

#### 强调重点

```
最重要的...
核心是...
关键是...
```

#### 情感调动

```
太神奇了！
不可思议！
令人惊叹！
```

## 五、视觉元素使用

### 5.1 Emoji 使用规范

* **适度使用**：每段不超过2-3个emoji
* **语义匹配**：emoji 与内容语义相符
* **位置合理**：通常放在标题或要点开头
* **一致性**：同一类型内容使用相同风格的emoji

### 5.2 常用 Emoji 分类

> **注意**: 以下 emoji 仅供参考。根据 Mintlify 写作标准，只有在用户明确要求时才使用 emoji。

```
🎯 目标/重点    🔥 热门/重要    💡 创意/想法
📊 数据/分析    ⚡ 效率/快速    🚀 发展/进步
🤖 AI/技术     📝 写作/内容    🎨 设计/创意
✨ 优化/改进    🔍 分析/研究    📋 计划/清单
```

### 5.3 对比框使用

```
✅ 正确做法：
- 具体、可执行的建议

❌ 错误做法：
- 模糊、不可操作的建议
```

### 5.4 列表设计

* **符号统一**：同一级别使用相同符号
* **缩进规范**：不同级别使用不同缩进
* **要点清晰**：每个要点不超过2行
* **逻辑顺序**：按照重要性或时间顺序排列

## 六、技术内容写作规范

### 6.1 代码展示

* **语言标注**：明确标注代码语言
* **注释完整**：关键代码添加注释说明
* **格式规范**：使用统一的代码风格
* **示例完整**：提供完整的可执行示例

### 6.2 架构图设计

* **层次清晰**：使用缩进或连线表示层次关系
* **符号统一**：使用一致的符号和颜色
* **标注详细**：重要组件添加说明文字
* **流程明确**：箭头指向清晰，流程可追踪

### 6.3 配置示例

* **格式规范**：使用代码块展示配置
* **版本说明**：注明适用版本
* **参数解释**：重要参数添加说明
* **注意事项**：标注使用注意事项

## 七、内容组织技巧

### 7.1 信息密度控制

* **段落长度**：每段3-5行，避免过长段落
* **要点数量**：每个部分3-7个要点
* **信息层次**：重要信息前置，次要信息后置
* **空白利用**：适当使用空行增强可读性

### 7.2 逻辑结构

```
总分总结构：
- 总：概述主题和核心观点
- 分：详细展开各个要点
- 总：总结和行动建议

递进结构：
- 从问题到解决方案
- 从基础到高级
- 从概念到实践

对比结构：
- 传统 vs 现代
- 错误 vs 正确
- 简单 vs 复杂
```

### 7.3 过渡技巧

* **承上启下**：使用过渡句连接不同部分
* **逻辑连接**：使用"首先、其次、最后"等词汇
* **问题引导**：用问题引导读者思考
* **总结预告**：总结前文并预告下节内容

## 八、SEO 和传播优化

### 8.1 关键词布局

* **标题关键词**：核心关键词在标题中
* **首段关键词**：前100字包含主要关键词
* **自然分布**：关键词在文中自然分布
* **相关词汇**：使用同义词和相关词汇

### 8.2 描述性元素

* **Meta描述**：简洁概括文章价值
* **Alt文本**：图片包含描述性文字
* **内部链接**：适当链接相关文章
* **外部引用**：引用权威资料和数据

### 8.3 可读性优化

* **段落结构**：清晰的段落划分
* **重点突出**：使用加粗、斜体等格式
* **列表使用**：复杂信息使用列表展示
* **总结要点**：关键信息用要点总结

## 九、实用模板库

### 9.1 文章开头模板

```
模板1 - 问题引入：
你有没有遇到过[具体场景]？当你[描述问题]时，是否感到[情感体验]？其实，[给出希望]，关键在于[引出解决方案]。

模板2 - 场景描述：
[时间/地点]，一个[背景描述]的场景。[具体事件]正在发生，而这背后隐藏着[核心洞察]。

模板3 - 数据震撼：
[具体数字]的[统计数据]显示，[现象描述]。这个数字背后反映的是[深层含义]。
```

### 9.2 章节过渡模板

```
承上启下：
前面我们了解了[前文内容]，接下来我们将深入探讨[本节主题]。

递进关系：
在掌握[基础概念]之后，我们来看看[进阶内容]。

对比转折：
虽然[传统方法]有一定效果，但是[新方法]的优势更加明显。
```

### 9.3 结尾总结模板

```
行动导向：
通过本文的学习，我们了解了[核心内容]。现在你可以[具体行动建议]，开始[实践指导]。

展望未来：
[当前趋势]正在改变[行业/领域]。掌握[核心技能]将帮助你在[未来场景]中获得优势。

价值回归：
记住，[核心观点]。无论技术如何变化，[底层逻辑]始终是[关键要素]。
```

## 十、质量检查清单

### 10.1 标题检查

* 标题简洁明了，不超过25字
* 包含核心关键词
* 有具体承诺或数字
* 符合文章主题

### 10.2 结构检查

* 有清晰的开头、主体、结尾
* 章节层次分明，编号统一
* 段落长度适中（3-5行）
* 过渡自然，逻辑清晰

### 10.3 语言检查

* 语言口语化，亲和力强
* 语调热情，有感染力
* 避免过于正式的表达
* 使用恰当的语气词

### 10.4 视觉检查

* Emoji 使用适度且恰当
* 重点信息突出显示
* 列表格式规范统一
* 代码块格式正确

### 10.5 价值检查

* 提供具体的解决方案
* 包含实用的操作步骤
* 有明确的行动建议
* 内容对目标读者有价值

***

> **编写说明**：本文档基于 mp 目录下所有文章的实际分析，总结出的系统性写作风格规范。遵循此指南可以帮助创作出风格一致、读者友好的优质内容。
