Markdown Lint

Markdown ファイルを作成・編集した後に lint を実行するスキル。

重要

Markdown ファイル (*.md) を作成・編集した場合は、必ずこのスキルに従って lint を実行すること。

実行コマンド

just lint

対象ファイル

• *.md (すべての Markdown ファイル)
• 例: README.md, DEVELOPMENT.md, CHANGELOG.md
• 例: .claude/skills/**/SKILL.md
• 例: apps/blog/src/contents/*.md

手順

1. Markdown ファイルを作成・編集
2. just lint を実行してエラーを確認
3. エラーがあれば修正
4. 再度 just lint で確認（すべて Passed になるまで繰り返す）

よくあるエラーと修正方法

| エラー | 原因 | 修正方法 | | -------- | ------------------------------ | -------------------------------- | | MD041 | 最初の行が見出しでない | # タイトル を先頭に追加 | | MD040 | コードブロックに言語指定がない | ```bash のように言語を指定 | | textlint | 日本語の文法エラー | エラーメッセージに従って修正 | | cspell | 不明な単語 | cspell.json の words に追加 |

注意事項

• YAML front-matter がある場合、見出しはその直後に記述
• コードブロックには必ず言語を指定（text でも可）
• 日本語の助詞の重複に注意（textlint が検出）