К основному содержанию
скилл CX Codex

markdownlint — скилл для Claude Code: проверка Markdown

Скилл для Claude Code запускает проверки Markdown-файлов через markdownlint-cli2 и помогает исправлять нарушения. Проверяет также файлы Quarto (.qmd).

MIT 4 установок ★ 7 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add PovertyAction/ipa-stata-template --skill markdownlint -a claude-code
Открыть на GitHub

Что делает markdownlint

Скилл помогает проверять Markdown, находить нарушения правил стиля и применять автоматические исправления. Можно передать отдельный файл, каталог или glob-шаблон; также поддержана обработка текста из stdin. Для проверки и исправления используются команды markdownlint-cli2 и markdownlint-cli2 --fix.

В конфигурации проекта описаны правила .markdownlint.yaml: например, для блоков кода требуется указать язык, а ограничение длины строк отключено. Эти настройки относятся к конфигурации проекта, поэтому проверьте её перед запуском на другом репозитории. Сам CLI устанавливается отдельно: через npm или Homebrew.

Какие задачи решает

  • проверить Markdown-файлы на нарушения правил
  • автоматически исправить замечания в .md
  • проверить Quarto-документы .qmd
  • запустить линтер для выбранного каталога или glob-шаблона

Примеры запросов агенту

  • Проверь все Markdown-файлы в проекте и перечисли найденные нарушения.
  • Исправь автоматически замечания markdownlint в README.md, затем покажи изменения.
  • Проверь файлы в docs/ и исправь нарушения, которые поддерживают автоисправление.

Как установить markdownlint

1Через Skills CLI (Vercel)

npx skills add PovertyAction/ipa-stata-template --skill markdownlint -a claude-code

2Вручную: положить файлы

~/.claude/skills/markdownlint/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/markdownlint/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о markdownlint

Как установить markdownlint в Claude Code?

Выполните npx skills add PovertyAction/ipa-stata-template --skill markdownlint -a claude-code. Файл скилла находится по пути ~/.claude/skills/markdownlint/SKILL.md.

Что делает скилл markdownlint?

Он помогает проверять Markdown и файлы Quarto .qmd с помощью markdownlint-cli2, а также применять автоисправления через --fix.

Нужно ли отдельно устанавливать markdownlint-cli2?

Да. В инструкции приведены установка через npm install -g markdownlint-cli2 или brew install markdownlint-cli2 и проверка командой markdownlint-cli2 --help.

Исходный текст

SKILL.md · MIT
---
name: markdownlint
description: This skill should be used when users need to format, clean, lint, or validate Markdown files using the markdownlint-cli2 command-line tool. Use this skill for tasks involving Markdown (including Quarto Markdown `.qmd`) file quality checks, automatic formatting fixes, enforcing Markdown style rules, or identifying Markdown syntax issues.
---

# Markdownlint Skill

## Contents

- [Markdownlint Skill](#markdownlint-skill)
    - [Contents](#contents)
    - [Project Configuration](#project-configuration)
    - [Basic Usage](#basic-usage)
    - [Common Operations](#common-operations)
        - [Lint Specific Paths](#lint-specific-paths)
        - [Auto-Fix](#auto-fix)
        - [Process stdin](#process-stdin)
    - [Workflow](#workflow)
        - [Standard Lint-Fix-Verify Cycle](#standard-lint-fix-verify-cycle)
        - [Safe Fix with Backup](#safe-fix-with-backup)
    - [Cross-Platform Usage](#cross-platform-usage)
    - [Troubleshooting](#troubleshooting)
        - [No Files Matched](#no-files-matched)
        - [Too Many Issues](#too-many-issues)
        - [Configuration Not Loading](#configuration-not-loading)
    - [References](#references)
    - [Installation](#installation)

## Project Configuration

**IMPORTANT**: This project uses `.markdownlint.yaml`. Always follow these rules:

| Rule | Setting | Notes |
| ------ | --------- |------- |
| **MD040** | Enabled | Always specify language for code fences |
| **MD007** | 2 spaces | List indentation |
| **MD024** | Siblings only | Duplicate headings allowed under different parents |
| **MD013** | Disabled | No line length restrictions |
| **MD033** | Disabled | Inline HTML allowed |
| **MD041** | Disabled | Files don't need to start with H1 |
| **MD038** | Disabled | Spaces in code spans allowed |
| **MD036** | Disabled | Emphasis as heading allowed |

## Basic Usage

```bash
# Lint files
markdownlint-cli2 "**/*.md"
markdownlint-cli2 README.md

# Auto-fix issues
markdownlint-cli2 --fix "**/*.md"

# Exclude directories
markdownlint-cli2 "**/*.md" "#node_modules" "#vendor"
```

## Common Operations

### Lint Specific Paths

```bash
markdownlint-cli2 README.md                    # Single file
markdownlint-cli2 "docs/**/*.md"               # Directory
markdownlint-cli2 "*.md" "docs/**/*.md"        # Multiple patterns
markdownlint-cli2 .                            # Current directory
```

### Auto-Fix

```bash
markdownlint-cli2 --fix "**/*.md"              # Fix all files
markdownlint-cli2 --fix README.md              # Fix single file
```

### Process stdin

```bash
cat README.md | markdownlint-cli2 -
```

## Workflow

### Standard Lint-Fix-Verify Cycle

1. Run lint check: `markdownlint-cli2 "**/*.md"`
2. Review reported issues
3. Apply auto-fix: `markdownlint-cli2 --fix "**/*.md"`
4. Re-run lint to verify: `markdownlint-cli2 "**/*.md"`
5. Review changes: `git diff`
6. Commit when satisfied

### Safe Fix with Backup

1. Stage current state: `git add .`
2. Create backup commit: `git commit -m "Backup before markdownlint fix"`
3. Apply fixes: `markdownlint-cli2 --fix "**/*.md"`
4. Review changes: `git diff`
5. Commit fixes or reset: `git add . && git commit -m "Apply markdownlint fixes"`

## Cross-Platform Usage

For maximum compatibility:

- **Quote glob patterns**: `markdownlint-cli2 "**/*.md"`
- **Use `#` for negation**: `markdownlint-cli2 "**/*.md" "#vendor"` (not `!`)
- **Use forward slashes**: `docs/**/*.md` (works on all platforms)
- **Stop option processing**: `markdownlint-cli2 -- "special-file.md"`

## Troubleshooting

### No Files Matched

- Verify glob patterns are quoted
- Check file extensions (`.md` vs `.markdown`)
- Ensure negated patterns don't exclude everything

### Too Many Issues

1. Start with auto-fix: `markdownlint-cli2 --fix "**/*.md"`
2. Disable problematic rules temporarily
3. Address remaining issues incrementally

### Configuration Not Loading

- Verify configuration file name matches expected patterns
- Validate JSON/YAML syntax
- Use `--config` to explicitly specify the file

## References

- [Rules Reference](references/rules.md) - Complete rule descriptions
- [Configuration Examples](references/config-examples.md) - Config templates and patterns
- [Official Documentation](https://github.com/DavidAnson/markdownlint-cli2)
- [All Rules](https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md)

## Installation

```bash
npm install -g markdownlint-cli2    # npm
brew install markdownlint-cli2      # Homebrew
markdownlint-cli2 --help            # Verify installation
```

© PovertyAction · MIT · PovertyAction/ipa-stata-template

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
documentation-standards pr-pm Скилл documentation-standards задаёт правила структуры документации: разделяет внутренние инструкции для контрибьюторов, пользовательские руководства в docs/ и скиллы в .claude/skills/. CX Codex +1 1установок markdown microsoft Задаёт стандарты разметки Markdown и схемы YAML frontmatter для всех файлов .md в проекте. Помогает агенту форматировать тексты без ошибок линтера. CX Codex +1 ★ 1 627звёзд репо quarto-authoring Mickaël Canouil (@mcanouil) Скилл quarto-authoring для Claude Code и ещё пяти ассистентов кодинга, который подгружает правила работы с Quarto: структура документов, ячейки кода, перекрёстные ссылки, цитаты, диаграммы. CX Codex +1 1 500установок humanize Claude Code Academic Workflow Скилл humanize находит штампы и речевые маркеры нейросетей в текстах LaTeX, Quarto и Markdown. Создаёт отчёт с проблемными местами перед подачей статьи в журнал. CX Codex +1 ★ 1 729звёзд репо visual-audit pedrohcgs Скилл visual-audit ищет переполнение слайдов, шрифтовой разнобой и лишние плашки в Quarto и Beamer. Помогает проверить вёрстку презентаций до показа аудитории. CX Codex +1 ★ 1 729звёзд репо brand-yml Garrick Aden-Buie (@gadenbuie) Скилл собирает и правит файлы _brand.yml, чтобы цвета, шрифты и логотипы совпадали в Shiny-приложениях и документах Quarto. CX Codex +1 1 000установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой