testing-verification-knowledge

name	testing-verification-knowledge
description	How to test and visually verify awesome-md-to-pdf changes. Covers the samples fixtures, npm run demo:light/dark smoke tests, scripts/verify-fullbleed.js (A4 PNG harness), scripts/pdf-page1-to-png.js (real-PDF first-page snapshot), the CI --help smoke test, where outputs land, and the visual-regression checklist. Use when authoring tests, verifying a rendering change, generating goldens, or reviewing a PR that touches the pipeline.
triggers	smoke test, verify full-bleed, verify-fullbleed.js, pdf-page1-to-png.js, samples/, samples/out, samples/out-dark, demo:light, demo:dark, visual regression, golden PNG, A4, 794x1123, PDF snapshot, CI smoke test, testing, --help, samples fixture, visual diff, baseline PNG, convert smoke, end-to-end test, README.md as fixture

Testing & visual verification

This repo has no unit test harness. It relies on a tight set of end-to-end visual checks. This skill documents every check, what it proves, and how to fail fast.

Fixtures

Authored fixtures under samples/:

• samples/README.md and samples/demo.md — the canonical demos. Exercise headings, admonitions, tables, code blocks (multiple languages), mermaid, KaTeX, task lists, footnotes, emoji.
• samples/bug-<id>/ — per-bug repro fixtures produced during triage. Check in the repro markdown; do NOT check in the generated PDFs.

Output directories:

• — default output of / .