xiaohongshu-article-writing-guide

name	xiaohongshu-article-writing-guide
description	发表于小红书的文章的写作规范。Technical articles for Xiaohongshu with structured format, concise sections, and natural human-like writing that avoids AI-style phrasing. Use when writing or polishing rednotes content.

小红书技术文章写作规范

文章结构要求

Frontmatter 格式

• title：简洁明确的标题，突出核心技术概念
• description：80-120 字的文章摘要，包含关键技术点
• pubDatetime：发布时间，使用 ISO 8601 格式
• tags：3-5 个相关技术标签，便于分类检索

内容长度控制

• 一级标题：即开始的内容介绍，控制在 200 字左右
• 二级标题：每个小节内容 150-250 字，且每个二级标题前使用 --- 分隔。生成二到四个二级标题内容。
• 保持内容精炼，避免冗余描述

写作风格指南

技术概念阐述

• 先给出概念定义，再解释工作原理
• 使用具体示例说明抽象概念
• 突出关键词使用 **粗体** 标记
• 专业术语首次出现时提供简要解释

代码示例规范

// 提供完整、可运行的代码示例
// 添加必要的注释说明关键逻辑
const example = {
  traceId: "4bf92f3577b34da6a3ce929d0e0e4736",
  spanId: "00f067aa0ba902b7"
};

结构组织原则

1. 概念介绍：从核心概念开始
2. 技术细节：深入具体实现
3. 实际应用：提供真实场景示例
4. 最佳实践：总结使用建议

语言表达要求

• 使用简洁、准确的技术表达
• 避免口语化表述，保持专业性
• 中英文混排时注意空格规范
• 专业名词使用 "``" 包裹，如 OpenTelemetry

避免 AI 风格

撰写或润色时，文字要自然、人性化，避免明显的 AI 生成痕迹：

• 少用或不用「首先、其次、此外、综上所述、毋庸置疑、在这个……的时代」等套话与模板式过渡
• 避免排比堆砌、空洞升华、过度对称的句式结构
• 用具体技术细节和实例替代抽象概括，用动词和名词替代形容词堆砌
• 保持技术文章的专业性，但语言要流畅自然，像有经验的开发者在分享经验
• 避免「赋能」「助力」「打造」等营销话术渗入技术内容