CarveA post-Markdown markup language

Quick Reference ​

Frontmatter ​

---
title: My Document
tags: [carve, markup]
---

A leading --- fenced block holds document metadata. Add a format token to the opening fence for non-YAML metadata (---toml, ---json, or any label); a bare --- uses the configurable default format (yaml unless the host sets defaultFrontmatterFormat):

---toml
title = "My Document"
---

Carve holds the content raw - the verbatim text plus the format label - and does not parse it; your application interprets the declared format. The block is leading-only and never rendered as body content.

Emphasis ​

/italic/   *bold*   /*bold italic*/
_underline_   ~strikethrough~
^super^   ,sub,   =highlight=

Headings ​

# H1
## H2
### H3
#### H4

Links & images ​

[link text](https://url.com)
[Page Name][]              (wiki-style)
![alt text](image.jpg)

Captions (images, quotes, tables) ​

![Photo](img.jpg)
^ Figure 1: Caption text

Lists ​

- unordered item
1. ordered item
- [ ] task
- [x] done

Code ​

`inline code`

```language
code block
```

Math ​

Inline: $`e^{i\pi} + 1 = 0`
Display: $$`\int_0^1 x \, dx`

Quotes & admonitions ​

> quoted text
^ Attribution

::: note
admonition content
:::

Tables ​

|= Header |= Header |      (|= for headers)
| Cell    | Cell    |
|= Row    | Cell    |      (|= in a body row = row header)
^ Table caption

| ^       | spanned |      (^ rowspan)
| Header  | <       |      (< colspan)
+ continuation cell  |     (+ multiline)

Abbreviations ​

*[HTML]: HyperText Markup Language

Attributes ​

{#id .class key=value}

Extensions, mentions, tags ​

:youtube[VIDEO_ID]
@username   #tagname

Comments ​

%% whole-line comment
text %% trailing comment
%%%
block comment
%%%

Status ​

Carve is a design exploration. The specification lives in the Case Study. Reference material covers the normative extensions contract, the technical rationale, parsing edge cases, native features, and the broader markup landscape.

Looking for a parser, editor plugin, or framework integration? See the Ecosystem. Want to write your own? Start with Build Your Own Implementation.

File extension: .crv

Influences ​

• Djot (John MacFarlane) — rigorous parsing, attributes, foundation
• Org-mode — /italic/ syntax, TODO states
• Creole — |= table headers
• AsciiDoc — admonitions, document structure
• CriticMarkup — editorial annotations