DereuromarkMark6 min readintermediate
From Markdown to Carve
Summary
This article guides engineers through migrating Markdown content to Carve, a new markup language. It covers mechanical conversion, key syntax differences like emphasis and list formatting, and using Carve's linter to ensure correctness before publishing.
- Carve uses distinct visual mnemonics for emphasis (e.g., /italic/, *bold*, _underline_).
- Heading attributes in Carve precede the heading, unlike some Markdown dialects.
- Lists in Carve require a blank line to separate them from preceding paragraphs.
- Raw HTML is explicit in Carve via {=html} or =html blocks, enhancing security.
Engineers considering or migrating to Carve will find this a practical guide, detailing specific syntax changes, tooling, and post-conversion checks to ensure a smooth transition.
7/10
