validate
Overview
Validate markdown documents against naming, YAML frontmatter, and markdown formatting rules. Supports folder scanning, tag filtering, auto-fix with preview, conflict detection, and multiple output formats. Five validators run on each document: YAML, Naming, Markdown, Brand Voice, and Content Rules.
Usage
python main.py validate [OPTIONS]
Options
| Option | Description | Default |
|---|---|---|
--path | Validate specific folder | Config default or . |
--file | Validate specific file(s); repeatable | -- |
--tags | Filter by tag (comma-separated) | -- |
--force | Ignore cache and revalidate all | false |
--auto-fix | Automatically fix issues where possible | false |
--preview | Preview auto-fixes without applying | false |
--conflicts | Run conflict detection only | false |
--format | Output format: console, markdown, json | console |
--output | Output file for report | stdout |
--min-severity | Minimum severity: ERROR, WARNING, INFO | Config or INFO |
Prerequisites
- Repo: content-conductor
- Install:
pip install -r requirements.txtfrom repo root
Examples
Validate all documents
python main.py validate
Validate a specific folder
python main.py validate --path operations/
Auto-fix with preview
python main.py validate --auto-fix --preview
Generate markdown report
python main.py validate --format markdown --output report.md
Related Commands
cc health-check-- check repository health