技能 markdown
📝

markdown

安全 🌐 网络访问⚙️ 外部命令

自動檢測並修復 Markdown 格式

也可从以下获取: 46ki75

Markdown 檔案常見的風格不一致問題會降低可讀性。此技能使用 markdownlint-cli2 自動偵測並修復常見格式問題，同時識別需要人工判斷的問題。

支持: Claude Codex Code(CC)
📊 69 充足
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“markdown”。 Check and fix all markdown issues in my README.md file

预期结果:

  • Initial scan: 18 errors detected
  • After auto-fix: 4 errors remaining
  • Manual corrections needed:
  • - MD025: Converted 2 duplicate H1 headers to H2 level
  • - MD036: Changed bold emphasis to proper H2 header
  • - MD013: Wrapped long line at natural punctuation break
  • Final verification: 0 errors - document is fully compliant

正在使用“markdown”。 Lint all markdown files in the docs folder

预期结果:

  • Scanning 12 markdown files in docs/**/*.md
  • Auto-fix applied to all files
  • Results: 8 files clean, 4 files need manual review
  • Common issues: Multiple H1 headers and line length violations
  • Estimated manual fixes: 10-15 minutes

质量评分

38
架构
100
可维护性
85
内容
22
社区
100
安全
91
规范符合性

你能构建什么

標準化文件風格

確保所有專案文件遵循一致的 Markdown 慣例和風格規則，涵蓋數十個檔案。

清理 README 檔案

在發布前驗證並修復 README 檔案、貢獻指南和文件中的 Markdown 格式。

提升文章可讀性

清理博客文章和教育內容中的 Markdown 格式，以符合發布標準。

试试这些提示

快速語法檢查 
Check this markdown file for style issues
自動修復常見問題 
Run markdownlint-cli2 with --fix to automatically correct formatting issues in document.md
自訂配置 
Lint this markdown with a custom config that sets line length to 120 characters and allows HTML
完整工作流程 
Apply the complete markdown workflow: auto-fix, check remaining errors, manually fix structural issues, and verify zero errors

最佳实践

  • 始終先執行自動修復來處理機械性問題，再進行手動審查
  • 建立專案特定的 markdownlint 配置文件以定義一致的規則
  • 在確認工作完成前，驗證最終輸出顯示零錯誤

避免

  • 不使用自動修復而手動修復所有問題（在機械性問題上浪費時間）
  • 禁用所有顯示錯誤的規則，而不是理解和修復問題
  • 跳過最終驗證步驟，假設自動修復已解決所有問題

常见问题

此技能檢查哪些 Markdown 規則？
支援所有 markdownlint 規則，包括標題層級、列表格式、尾隨空格、行長度、空白行和程式碼區塊格式。
我可以自訂要強制執行哪些規則嗎？
可以。建立 .markdownlint.json 檔案來啟用、停用或配置規則，如行長度閾值和 HTML 允許設定。
自動修復會修改我的原始檔案嗎？
可以。--fix 標記會原地修改檔案。使用版本控制或在副本上操作以保留原始檔案。
為什麼自動修復後仍有一些錯誤？
自動修復僅處理機械性問題。結構性問題（如文件層級和分行位置）需要人工判斷。
此技能會存取哪些檔案？
僅處理您明確指定的 Markdown 檔案。不會存取系統檔案、憑證或敏感資料。
這與其他格式化工具相比如何？
使用 markdownlint-cli2，它遵循全面的語法檢查規則，具有詳細的錯誤碼，比基本格式化工具更徹底。

开发者详情

作者

46ki75

许可证

MIT

仓库

https://github.com/46ki75/skills/tree/main/public/markdown

引用

main

文件结构

📄 SKILL.md