生产力
obsidian-markdown-structure
验证并强制执行 Markdown 文档结构,包含 YAML 前言定位、标题层级规范以及 Obsidian 知识库的内容组织。
简介
obsidian-markdown-structure 技能为 Obsidian 知识库或通用知识管理系统提供了一套自动化框架,用于维护高质量且格式一致的 Markdown 文件。此工具专为作家、研究人员与个人知识管理 (PKM) 爱好者设计,确保每份文件都遵循标准化结构模板,从而使文件更易于浏览、搜寻与程序化处理。通过强制执行元数据的特定摆放位置与标题层级,能有效防止大型知识库中常见的结构混乱问题。
-
自动验证 YAML 前言 (frontmatter) 是否位于文件最顶端,并确保其后留有空行以利解析。
-
强制执行严格的标题层级规范 (从 H2 开始),以维持文件流程并避免重复元数据中已有的标题。
-
验证内容是否遵循逻辑组织流程,例如要求在详细章节前必须具备摘要结构。
-
确保引用区块 (quote blocks) 具备正确的格式与署名,提升可读性与参考完整性。
-
提供结构一致性的检查清单,包含跳级标题检查与主标题前的非法内容侦测。
-
适用于从模板建立新笔记、验证现有 Markdown 文件的结构合规性,或在进行大量清理时修复格式错误。
-
可与 obsidian-yaml-frontmatter 或 obsidian-links 等其他 PKM 技能无缝协作,维持专业且整洁的知识库生态系统。
-
输入需求为标准 Markdown 文件;此工具会进行字符级的结构分析,确认其是否符合位置与组织规则。
-
请注意,此技能专注于处理文件拓扑结构,不负责验证前言内的数值内容 (该部分应交由 YAML 专用工具处理)。
-
非常适合利用 AI 代理进行自动化维护与质量控制的进阶用户。
仓库统计
- Star 数
- 43
- Fork 数
- 7
- Open Issue 数
- 0
- 主要语言
- Python
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月1日 08:05