김경종
28 lines
908 B
Markdown
28 lines
908 B
Markdown
---
|
|
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.
|