PDFToMD/phases/2-marker-adapter/step2.md

Step 2: marker-block-normalization

Read First

• /AGENTS.md
• /PLAN.md
• /PROGRESS.md
• /docs/HARNESS.md
• /docs/IMPLEMENTATION_PLAN.md
• /docs/ARCHITECTURE.md
• /docs/CONVERSION_POLICY.md
• /phases/0-harness-foundation/step1.md
• /phases/2-marker-adapter/step0.md

Task

Map Marker structured output into the internal block model for headings, paragraphs, lists, tables, figures, captions, and equation candidates.

Prefer structured Marker APIs or JSON-like structures over scraping final Markdown.

Sprint Contract

• Done means: fake Marker structures and at least one real or recorded sample shape map into internal block types.
• Hard thresholds: semantic block roles are preserved; bounding boxes and page numbers survive where available; formula blocks are only marked as candidates for Phase 3.
• Files owned: src/pdftomd/marker_adapter.py, model additions if required, tests, PROGRESS.md, phase index.
• Dependencies: Phase 0 models and Step 0 adapter.

Acceptance Criteria

python scripts\validate_workspace.py
.\venv\python.exe -m pytest tests

Verification

1. Run the acceptance commands.
2. Confirm no final Markdown scraping is required for normal block mapping.
3. Update PROGRESS.md and this phase index.

Do Not

• Do not perform Nougat conversion.
• Do not render Markdown.
• Do not discard page or bounding-box metadata without a documented reason.