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
手順
- Markdown ファイルを作成・編集
just lint を実行してエラーを確認- エラーがあれば修正
- 再度
just lint で確認（すべて Passed になるまで繰り返す）
よくあるエラーと修正方法
| エラー |
原因 |
修正方法 |
| MD041 |
最初の行が見出しでない |
# タイトル を先頭に追加 |
| MD040 |
コードブロックに言語指定がない |
```bash のように言語を指定 |
| textlint |
日本語の文法エラー |
エラーメッセージに従って修正 |
| cspell |
不明な単語 |
cspell.json の words に追加 |
注意事項
- YAML front-matter がある場合、見出しはその直後に記述
- コードブロックには必ず言語を指定（
text でも可）
- 日本語の助詞の重複に注意（textlint が検出）
