---
name: markdown-quality
description: Plan and review Markdown output quality for PDFtoMD. Use when Codex needs tests or policies for headings, tables, HTML fallback, image links, captions, frontmatter, chunk integrity, and deterministic output.
---

# Markdown Quality

## Workflow

1. Read `AGENTS.md`, `docs/PRD.md`, `docs/ARCHITECTURE.md`, and `docs/CONVERSION_POLICY.md`.
2. Prefer focused assertions over full snapshots.
3. Validate:
   - heading hierarchy
   - table parseability
   - limited HTML table fallback
   - image link existence
   - figure/table captions
   - internal references
   - chunk frontmatter
   - deterministic filenames and anchors
4. Use Markdown or HTML parsers when practical.

## Guardrails

- Do not inject runtime warnings into generated Markdown.
- Do not rely only on brittle whole-file snapshots.
- Do not lose complex table content without linking a fallback asset.
