跳到主要内容

内容写作规范

规范目标

  • 命名一致,便于检索
  • Frontmatter 结构稳定
  • 内容粒度清晰,便于复用

最小结构

  • 背景与目标
  • 过程与决策
  • 结果与复盘
  • 可迁移的做法

文件命名建议

  • docs:kebab-case,表达主题
  • blog:YYYY-MM-DD-主题.md

评论开关

  • blog:默认开启,需要关闭时加 comments: false
  • docs:默认关闭,需要开启时加 comments: true

图表支持

  • Mermaid:使用 ```mermaid 代码块即可