markup-carve / carve-php

0.1.16 2026-10-25 19:11 UTC

Requires

• php: ^8.2

Requires (Dev)

• brianium/paratest: ^7.8
• nikic/php-fuzzer: ^0.0.11
• php-collective/code-sniffer: ^0.6.8
• phpstan/phpstan: ^2.1.32
• phpunit/phpunit: ^11.0 || ^12.0 || ^13.0

Suggests

• ext-dom: Required for HTML import and HTML heading-ID conversion.
• ext-intl: Recommended for heading-ID transliteration: enables ICU romanization of non-Latin scripts (e.g. CJK, Arabic). Without it, a baked map covers Latin/Cyrillic/punctuation identically and other scripts fall back to the generated `section` id.

MIT

• Mark Scherer
• PHP Collective (djot-php, upstream)

• parser
• markup
• djot
• carve

Published on Packagist.org on 2026-10-25 19:14 UTC

README

carve-php parses and renders Carve in PHP. It implements Carve spec 0.1. Read the Carve documentation for the language.

Install

composer require markup-carve/carve-php

Usage

use MarkupCarve\Carve\CarveConverter;

$converter = new CarveConverter();
$document = $converter->parse('# Hello /Carve/');
$html = $converter->render($document);

CLI basics:

vendor/bin/carve README.crv > README.html
vendor/bin/carve lint README.crv
vendor/bin/carve fmt README.crv
vendor/bin/carve migrate --from html page.html

Documentation

• Carve documentation
• Sandbox
• Engine guides
• Security for untrusted input
• Development and contributing