生產力
obsidian-markdown-structure avatar

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
在 GitHub 查看