Getting Started

Carve markup language integration for Laravel applications.

What is Carve?

Carve is a post-Markdown lightweight markup language building on the foundations of Djot, John MacFarlane's post-Markdown project. It addresses Markdown's complexity issues:

• Cleaner syntax — more consistent rules, fewer edge cases
• More features — footnotes, definition lists, task lists, math, highlights, and more
• Easier to parse — simpler specification, faster implementations
• Better extensibility — designed for customization

Features

This package provides:

• Blade directives — @carve, @carveRaw, @carveText
• Facade — Carve::toHtml(), Carve::toText(), Carve::toHtmlRaw()
• Service injection — CarveConverterInterface and CarveManager for controllers and services
• Validation — ValidCarve rule for request validation
• Multiple profiles — different configurations for different contexts (e.g. user content vs. admin content)
• Safe mode — XSS protection for untrusted input (enabled by default)
• Caching — optional caching of rendered output via any Laravel cache store
• Plain text — extract plain text for search indexing or previews

Quick Start

composer require markup-carve/laravel-carve

{{-- In your Blade views --}}
@carve($article->body)

// In your services
public function __construct(
    private CarveConverterInterface $carve,
) {}

public function render(string $content): string
{
    return $this->carve->toHtml($content);
}

Requirements

• PHP 8.2 or higher
• Laravel 11.x, 12.x or 13.x

Demo Application

See the Laravel Carve Demo for a complete example application.