跳转至

元数据与命名规范

一、每个页面的 frontmatter

---
title: 页面标题                # 必填,与文件名一致,不含序号
type: 域页面 | 规范 | 实体 | 概念 | 指标 | 规则 | 流程 | 方法 | 案例 | 综合
status: 草案 | 待确认 | 生效中 | 已废止
owner: 部门名                  # 必填,谁对内容负责
updated: 2026-11-07           # 必填,最后实质修改日
source:                        # 可选,主要来源文件(相对 10_原始素材 或绝对路径)
  - 10_原始素材/asset/...
confidence: 高 | 中 | 低        # 可选,对资料把握程度,不等于执行状态
approved_by:                   # 仅制度/政策类必填;未审批就不要写
tags: [加盟, 费用]
---

写作约定:

  • status 是给人看的红绿灯,先看状态再看内容;
  • confidence 只描述「资料记载是否可靠」,不描述「是否合规」;
  • 制度、政策、合同条款类页面,approved_by 为空时正文首行必须写:> 未取得审批记录,以下仅为资料整理。

二、文件与目录命名

对象 规则 示例
域目录 NN_域名,NN 两位数字 04_加盟/
索引页 固定 00_索引.md 04_加盟/00_索引.md
页面文件 中文主题名,不加日期、不加版本号 加盟政策与费用.md
版本 不靠文件名,靠 frontmatter + git —
原始素材 保持原文件名,镜像原目录结构 10_原始素材/asset/商务部/...

禁止:最终版、最新、v2改、新建文档、副本 这类无法判断含义的名字进入 wiki 层。原件里的这类名字保留在 10_原始素材/,由 wiki 页面注明「原名 xx」。

三、链接

  • 内部链接一律用相对路径 Markdown 链接:加盟政策;
  • 指向原始素材用 原件;
  • 外部链接写全 URL,并在链接文字里带来源名与日期;
  • 不用 Obsidian 的 [[wikilink]] 作为唯一链接方式(导出/网页端会失效)。

四、表格优先

金额、费用、指标、政策条款、岗位职责,一律用表格。表格第一列是可检索的键(项目名、指标名、岗位名),不要写成一段话。

五、单位与口径

  • 金额写「元」,大额可写「万元」但同一张表内统一;
  • 比例写「%」,千分比写「‰」并在括号里补百分比;
  • 日期写 YYYY-MM-DD;业务期间写 2026-10-01 至 2026-10-31;
  • 涉及营业额必须注明:含/不含外卖、折前/折后、是否含充值。