| 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"
};
结构组织原则
- 概念介绍:从核心概念开始
- 技术细节:深入具体实现
- 实际应用:提供真实场景示例
- 最佳实践:总结使用建议
语言表达要求
- 使用简洁、准确的技术表达
- 避免口语化表述,保持专业性
- 中英文混排时注意空格规范
- 专业名词使用 "``" 包裹,如
OpenTelemetry
避免 AI 风格
撰写或润色时,文字要自然、人性化,避免明显的 AI 生成痕迹:
- 少用或不用「首先、其次、此外、综上所述、毋庸置疑、在这个……的时代」等套话与模板式过渡
- 避免排比堆砌、空洞升华、过度对称的句式结构
- 用具体技术细节和实例替代抽象概括,用动词和名词替代形容词堆砌
- 保持技术文章的专业性,但语言要流畅自然,像有经验的开发者在分享经验
- 避免「赋能」「助力」「打造」等营销话术渗入技术内容