志趣社区内容规范与发帖指南
内容规范与发帖指南
本文档为志趣社区的官方发帖规范。遵循本指南有助于你的内容获得更多曝光和互动。
第一章 标题规范
1.1 标题格式
推荐采用 [类型] 核心内容 的结构:
| 类型 | 格式示例 | 适用场景 |
|---|---|---|
| 经验分享 | [经验] Claude Code MCP 配置完整指南 | 经过验证的实践总结 |
| 问题求助 | [求助] pgvector 索引构建速度慢如何优化 | 遇到具体技术问题 |
| 踩坑记录 | [踩坑] Cursor Agent 模式下 Git 冲突的排查 | 问题排查过程 |
| 工具推荐 | [推荐] 一个轻量级的 MCP Server 调试工具 | 工具/库/插件推荐 |
1.2 标题要求
- 准确描述帖子核心内容,避免模糊表述
- 长度控制在 15-50 字
- 不要使用「求助」「问个问题」等无信息量标题
- 不要在标题中使用大量特殊符号吸引注意
第二章 正文排版
2.1 Markdown 规范
编辑器支持完整 Markdown 语法:
| 元素 | 语法 | 用途 |
|---|---|---|
| 一级标题 | # 标题 | 仅用于文章题目 |
| 二级标题 | ## 标题 | 主要章节 |
| 三级标题 | ### 标题 | 子章节 |
| 粗体 | **文本** | 强调关键信息 |
行内代码 | `代码` | 变量名、命令、文件名 |
| 代码块 | ```语言\n代码\n``` | 多行代码,自动语法高亮 |
2.2 代码规范
- 完整的可运行代码优于片段
- 附带环境信息:操作系统、软件版本、依赖版本
- 报错日志完整:不截图,粘贴全文
- 注释充分:关键步骤解释清楚
# ✅ 推荐:环境信息 + 完整代码 + 注释
# Python 3.12 + FastAPI 0.115
from fastapi import FastAPI
app = FastAPI()
@app.get("/")
def root():
return {"message": "Hello World"}
0
0 5