# shiplog-render-md
Markdown packet renderer for canonical shiplog data.
## Main type
- `MarkdownRenderer` implements `shiplog_ports::Renderer`.
## Output behavior
- Includes coverage summary, completeness, sources, and warnings.
- Separates completed sources, skipped configured sources, and known gaps in the
packet coverage block.
- Renders workstream sections with claim scaffolds and receipt lists.
- Truncates long receipt lists in the main section and emits a configurable appendix.
- Includes artifact references (`ledger.events.jsonl`, `coverage.manifest.json`, etc.).
`MarkdownRenderer::render_packet_markdown` keeps the default full packet behavior.
`render_scaffold_markdown` emits coverage, summary, workstream prompts, and evidence
anchors without the full receipts appendix. `render_receipts_markdown` emits a dense
receipt/audit view.
Use `MarkdownRenderOptions` with the `*_with_options` methods to control
main-section receipt limits and choose a full, summary, or omitted appendix. A
receipt limit of `0` intentionally shows no main-section receipts while keeping
an omission notice when appendix detail is reduced.
The output is intentionally editable: users can refine narrative text directly in `packet.md`.