Document blocks: invoices, quotes and receipts from Markdown
Inkrun has always rendered Markdown literally: headings become headings, tables become tables. That is right for prose, and wrong for an invoice — which isn't prose at all, but a set of named regions. A masthead with your logo, two parties, a strip of reference fields, line items, a totals ladder, payment details.
Document blocks give those regions a vocabulary.
Added
- Five document blocks — fences tagged
```masthead,```parties,```meta,```totalsand```payment, using the same settings-and-table syntax as chart fences. Line items stay an ordinary Markdown table. Blocks work in every theme and inherit its palette and typography, so a custom theme restyles them for free. - An
invoicetheme — sans throughout, hairline dotted rules, borderless zebra line items, and a totals ladder that puts the amount due where the eye lands. Built for transactional documents: invoices, quotes, receipts, statements, purchase orders. - Computed totals — set
compute: true, name your net and tax columns, and write{net},{tax}or{gross}where the amounts go. Inkrun sums the line items and formats them for your currency and locale. This matters most when an agent writes the invoice: the model describes the work, Inkrun does the arithmetic. - Logos — a
logo:URL in your frontmatter is fetched and embedded in the PDF. PNG, JPEG or WebP, verified by magic bytes rather than by file extension. An unreachable logo costs the document its logo, never the render. - Footer notes —
footer_note:andfooter_page_label:print a standing line on every page, for the registration or certification text business documents carry. - Document blocks reference — the full vocabulary, with a worked invoice.
Note
Inkrun renders a document that looks like an invoice; it does not issue one. Where invoicing is certified — Portugal's ATCUD, Italy's SdI and similar — legally valid invoices must come from certified software. Use these blocks for quotes, proposals, statements and receipts, or to render documents whose numbering comes from your invoicing system.