markdownlint

markdownlint 技能為維護 Markdown 文件之完整性、風格與語法提供自動化專業知識。本技能專為開發人員、技術撰稿人及研究人員設計，旨在透過 markdownlint-cli2 工具確保儲存庫內的一致性。此技能可自動偵測常見語法錯誤、強制執行特定風格準則，並提供即時回饋或自動修正功能，以簡化文件編寫流程。

• 針對可配置規則檢查 Markdown 文件，以識別結構性問題、損壞的語法與格式不一致之處。

• 自動修正常見問題，減少維護程式碼時的手動編輯開銷。

• 強制執行專案特定規則，例如程式碼區塊強制要求語言識別碼 (MD040) 以及標準列表縮排 (MD007)。

• 支援萬用字元 (glob patterns) 以處理大型文件集，包括遞迴目錄處理與自訂排除項目。

• 與 CI/CD 管線整合，確保所有提交的 Markdown 內容在合併前均符合既定的品質基準。

• 支援標準輸入 (stdin) 以及如 .markdownlint.yaml 等自訂設定檔，可根據特定專案需求調整檢查標準。

• 本技能嚴格遵循 .markdownlint.yaml 中定義的專案設定；在進行變更前，請務必確認專案特定規則，例如是否允許內嵌 HTML (MD033) 或是否停用行長度限制 (MD013)。

• 使用 --fix 旗標進行大量風格違規修復，但在操作後請審查變更以確保保留預期的格式。

• 請務必為程式碼區塊指定語言 (例如 python, bash, json) 以滿足 MD040 的要求。

• 使用 # 字元進行檔案排除模式 (例如 #node_modules)，以確保 Windows 與 Unix 環境間的跨平台相容性。

• 此工具在處理標準 Markdown 檔案時極為高效，建議結合如 Vale 等其他文件工具進行文法與風格檢查。