# Markdown Lint

> Markdown ファイル編集後のリント実行。Markdown を作成・編集したら必ず実行。

- Skill: `majiayu000/markdown-lint` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/markdown-lint`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/markdown-lint/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/markdown-lint

---


# Markdown Lint

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

## 重要

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

## 実行コマンド

```bash
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 が検出）