PDFToMD/.codex/skills/markdown-quality/SKILL.md

name, description

name	description
markdown-quality	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.