Carve Syntax

This page uses ::: compare so the Carve source and rendered HTML stay beside each other.

Inline Delimiters

/italic/, *bold*, _underline_, ~strike~, and =highlight=.

italic, bold, underline, strike, and highlight.

<p><em>italic</em>, <strong>bold</strong>, <u>underline</u>, <s>strike</s>, and <mark>highlight</mark>.</p>

Markdown Collisions

**bold** and ~~strike~~ are literal Carve text, not emphasis.

**bold** and ~~strike~~ stay visible.

**bold** and ~~strike~~ stay visible.

<p>**bold** and ~~strike~~ stay visible.</p>

Heading Attributes

Attributes go on the line above the heading.

{#custom-id .tracked}
## Addressable Heading

See </#custom-id>.

Addressable Heading

See Addressable Heading.

<h2 id="custom-id" class="tracked">Addressable Heading</h2>
<p>See <a href="#custom-id">Addressable Heading</a>.</p>

Superscript And Subscript

Superscript and subscript are braced-only.

Area is m{^2^}; water is H{,2,}O.

Area is m2; water is H2O.

<p>Area is m<sup>2</sup>; water is H<sub>2</sub>O.</p>

Lists And Continuation

Bullets are - and *. A lone + continues the current list item.

- first
+ continued paragraph
- second

* also a bullet
  • first

    continued paragraph

  • second

  • also a bullet

<ul>
<li>
<p>first</p>
<p>continued paragraph</p>
</li>
<li>
<p>second</p>
</li>
<li>
<p>also a bullet</p>
</li>
</ul>

Definition Lists

:: Carve
:  The source markup.

:: CarvePress
:  The static site generator.
Carve
The source markup.
CarvePress
The static site generator.
<dl>
<dt>Carve</dt>
<dd>The source markup.</dd>
<dt>CarvePress</dt>
<dd>The static site generator.</dd>
</dl>

Comments

Comments start with %% and render nothing.

Visible.
%% Hidden from output.
Still visible.

Visible. Still visible.

<p>Visible.
Still visible.</p>

Admonitions And Nesting

Longer fences can contain shorter fences.

Cross-References

This paragraph links to Inline Delimiters and uses the implicit reference Inline Delimiters.

Details And Tabs

Native disclosure

The docs preset renders ::: details as a <details> widget.

Tabs are Carve admonitions.

The tabs extension turns them into CSS-only tab panels.

Edit this page

Last updated