# Validate Md

> Validates markdown files with YAML frontmatter against JSON Schema definitions.

- Skill: `majiayu000/validate-md` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/validate-md`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/validate-md/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- 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/validate-md

---


# Validating Markdown Files

## Instructions

1. **Run validation script** for the target directory containing a `schema.yaml` file:
   ```bash
   python validate-md.py <directory>
   ```

2. **Review results**:
   - Success: `✓ OK: filename.md is valid`
   - Errors: Shows validation error, field path, and file location

## Examples

**Example 1: Validate contacts directory**
```bash
python validate-md.py crm/contacts
```

Output:
```
✓ OK: smith-john.md is valid
✓ OK: doe-jane.md is valid
✓ SUCCESS: All 2 files are valid!
```

**Example 2: Validation error - missing required field**
```bash
python validate-md.py crm/opportunities
```

Output:
```
❌ deal-2024-q1.md validation error: 'stage' is a required property
   In file: crm/opportunities/deal-2024-q1.md
```

Fix: Add `stage: qualified` to the frontmatter.

## Scripts

- `validate-md.py` the python validation script

## Required Python Packages

- pyyaml - for parsing YAML frontmatter
- jsonschema - for validating against JSON Schema