1. 设计目标

随着笔记数量增加，单纯依靠文件夹管理会越来越困难，因此建立一套统一的笔记元数据规范，使每篇笔记具备：

• 唯一 ID
• 创建时间
• 更新时间
• 分类信息
• 发布控制
• 可访问链接
• 标签管理

同时保持 Markdown 文件的纯文本特性，方便：

• Git 管理
• Linux 命令批量处理
• 脚本自动化
• 发布到 Quartz、Astro、MediaWiki 等平台

本方案使用：

• Obsidian
• Templater 插件
• pinyin-pro
• YAML Front Matter

实现自动生成。

2. 笔记 Front Matter 规范

所有正式笔记统一使用：

---
id: 20260711161734-p0ye
title: "CloudCone环境安装"
created: 2026-07-11T16:17:34
updated: 2026-07-11T16:17:34
type: note
category: knowledge
description: ""
dg-publish: false
dg-permalink: 002-cloudcone-huan-jing-an-zhuang
tags:
  - knowledge
status: draft
---

字段说明

id

唯一编号。

格式：

YYYYMMDDHHmmss-随机4字符

例如：

20260711161734-p0ye

作用：

• 防止文件重名
• 方便数据库管理
• 未来迁移到其它系统保留唯一标识

title

笔记标题。

来源：

文件名

例如：

文件：

002-CLOUDCONE环境安装.md

生成：

title: "002-CLOUDCONE环境安装"

created

创建时间。

格式：

YYYY-MM-DDTHH:mm:ss

例如：

created: 2026-07-11T16:17:34

采用 ISO 时间格式，方便：

• 程序读取
• 排序
• 数据库导入

updated

更新时间。

创建时：

updated = created

以后修改笔记时手动更新或通过插件自动维护。

type

笔记类型。

默认：

type: note

以后可扩展：

例如：

type: article
type: project
type: daily
type: documentation

category

自动根据目录生成。

例如：

目录：

01-Knowledge/Linux/ArchLinux/

生成：

category: knowledge

目录对应：

description

简介。

默认：

description: ""

用于：

• Quartz SEO
• Astro Starlight 描述
• 搜索摘要

dg-publish

Digital Garden 发布控制。

默认：

dg-publish: false

表示：

不发布。

需要发布时：

dg-publish: true

dg-permalink

永久访问地址。

例如：

标题：

002-CLOUDCONE环境安装

生成：

002-cloudcone-huan-jing-an-zhuang

规则：

1. 英文转小写
2. 空格替换为 -
3. 中文转换拼音
4. 特殊字符删除

例如：

Linux服务器配置教程

生成：

linux-fu-wu-qi-pei-zhi-jiao-cheng

tags

标签。

例如：

tags:
  - linux
  - server

模板默认：

tags:
  - category

后续根据内容增加。

status

笔记状态。

默认：

status: draft

状态定义：

3. 模板目录结构

建议：

Knowledge
└── Template
    ├── 001-新建知识笔记.md
    ├── 002-已有笔记规范化.md
    ├── 003-补充YAML.md
    ├── 004-Daily.md
    └── tools
        └── pinyin-helper

4. 安装 pinyin-pro

电脑端版本使用完整中文拼音转换。

进入知识库：

cd ~/Documents/Notes/Obsidian/Knowledge

初始化：

npm init -y

安装：

npm install pinyin-pro

生成：

node_modules/
package.json
package-lock.json

建议：

加入：

.gitignore

忽略：

node_modules/

5. pinyin-helper 目录

推荐：

Knowledge
├── Template
└── tools
    └── pinyin-helper
        ├── node_modules
        ├── package.json
        └── package-lock.json

安装：

cd tools/pinyin-helper

npm init -y

npm install pinyin-pro

模板调用：

require(
"/home/bill/Documents/Notes/tools/pinyin-helper/node_modules/pinyin-pro"
)

6. 新建笔记流程

方法一：Templater命令

Obsidian：

Ctrl + P

执行：

Templater: Create new note from template

选择：

001-新建知识笔记.md

自动生成：

---
id:
title:
created:
updated:
...
---

7. 老笔记整理流程

对于已有 Markdown：

例如：

CLOUDCONE环境安装.md

执行：

002-已有笔记规范化

自动添加：

• id
• created
• updated
• category
• permalink

最终：

---
id: xxxx
title: CLOUDCONE环境安装
created:
updated:
...
---

8. 文件命名规范

正式笔记

推荐：

日期_标题

例如：

20260711_CLOUDCONE环境安装.md

或者：

002-CLOUDCONE环境安装.md

长期知识建议：

主题.md

例如：

ArchLinux安装.md
Docker备份方案.md

日记

统一：

YYYY-MM-DD.md

例如：

2026-07-11.md

项目记录

使用日期：

20260711-项目名称.md

例如：

20260711-WordPress迁移记录.md

9. 发布流程

Obsidian

作为：

原始知识库

保存全部内容。

MediaWiki

整理完成：

01-Knowledge

中的成熟知识。

Astro Starlight

发布：

05-Publish

中的文档。

WordPress

生活文章：

05-Publish/WordPress

10. 文件管理原则

不追求绝对无目录

目录用于：

• 生命周期管理
• 内容范围管理

不要用于：

• 细分类目

例如：

不要：

Linux
 └── Arch
      └── 软件
          └── 网络
              └── 配置

建议：

01-Knowledge
 └── Linux
      ArchLinux网络配置.md

通过：

• 标签
• 双链
• 搜索

关联。

11. 最终目标

形成：

Obsidian
    ↓
Markdown 原始知识库
    ↓
整理
    ↓
MediaWiki
    ↓
公开知识库

整理
    ↓
Astro Starlight
    ↓
技术文档

整理
    ↓
WordPress
    ↓
生活博客

总结

这套模板的核心思想：

文件负责存储，YAML负责描述，双链负责关联，目录负责管理生命周期。

避免再次出现：

• 300 个目录
• 文件难寻找
• 命名混乱
• 发布困难

同时保留 Markdown 最大优势：

• 永久可读
• 不绑定软件
• Linux 可批处理
• 可迁移到任何平台

这套结构可以支撑从现在的几千条笔记，到未来数万条笔记。你现在整理后的 00-System ~ 99-TMP 架构已经基本稳定，后续重点就是慢慢清理 99-TMP，不要再频繁重构整体结构。