tuchsoft/commonmark-ext-heading-shifter

A CommonMark extension to adjust (decrease) heading levels by a custom amount.

1.0.3 2025-07-17 11:42 UTC

Requires

• php: ^8.0
• league/commonmark: ^2.0

MIT

• Mattia Bonzi

• markdown
• extension
• commonmark
• level
• headings
• shifter

README

CommonMark extension for shifting heading levels by a configurable amount of levels.

Install

composer require tuchsoft/commonmark-ext-heading-shifter

Usage

use League\CommonMark\CommonMarkConverter;
use League\CommonMark\Environment;
use TuchSoft\CommonMarkHeadingShifter\HeadingShifterExtension;

$converter = new CommonMarkConverter([
    'heading_shifter' => [
        'shift_by' => 1
        ]
    ]);

$converter->getEnvironment()->addExtension(new HeadingShifterExtension());

$converter->convertToHtml("# Heading"); //<h2>Heading</h2>

Author

👤 Mattia Bonzi @ TuchSoft [e-mail]

• Website: tuchsoft.com
• Github: @tuchsoft

🤝 Contributing

Contributions, issues and feature requests are welcome!

Feel free to check issues page.