​

文章写作风格指南

基于 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 目录下所有文章的实际分析，总结出的系统性写作风格规范。遵循此指南可以帮助创作出风格一致、读者友好的优质内容。