attuladzan/gravity-editor-bundle

Symfony 8.1 bundle for gravity-ui/markdown-editor integration (forms, EasyAdmin 5, Twig)

v1.0.3 2026-02-28 21:42 UTC

Requires

• php: >=8.2
• symfony/config: ^6.4|^7.0|^8.0
• symfony/dependency-injection: ^6.4|^7.0|^8.0
• symfony/form: ^6.4|^7.0|^8.0
• symfony/framework-bundle: ^6.4|^7.0|^8.0
• symfony/twig-bundle: ^6.4|^7.0|^8.0

Requires (Dev)

• phpunit/phpunit: ^10.0
• symfony/phpunit-bridge: ^6.4|^7.0|^8.0

Suggests

• easycorp/easyadmin-bundle: ^5.0 - For EasyAdmin 5 Field integration
• twig/extra-bundle: ^3.0 - For markdown_to_html in EasyAdmin field template

MIT

• symfony
• twig
• form
• markdown
• bundle
• editor
• easyadmin
• gravity-ui

README

Symfony-интеграция редактора @gravity-ui/markdown-editor — WYSIWYG + Markup, ProseMirror/CodeMirror, YFM.

Разработчик: attuladzan

Сообщества / Communities

	Русский	English
Gravity UI	Telegram: @gravity_ui (новости), @gravity_ui_chat (чат)	GitHub · gravity-ui.com
Бандл	GitHub Issues	Packagist

Установка

composer require attuladzan/gravity-editor-bundle

Без Flex — добавьте в config/bundles.php:

Attuladzan\MarkdownEditorBundle\AttuladzanMarkdownEditorBundle::class => ['all' => true],

Установка ассетов:

php bin/console attuladzan:markdown-editor:install-assets

Опции: --symlink (для разработки), --build (пересборка перед установкой).

Конфигурация

# config/packages/attuladzan_markdown_editor.yaml
attuladzan_markdown_editor:
    editor:
        allow_html: false
        sticky_toolbar: true
        autofocus: false
        lang: en   # или ru
    plugins:
        mermaid: false   # диаграммы Mermaid
        latex: false    # формулы LaTeX
        html: false     # HTML-блоки

Плагины

Плагины расширяют возможности редактора по документации:

Плагин	Описание	Зависимость
mermaid	Диаграммы Mermaid	@diplodoc/mermaid-extension
latex	Формулы LaTeX/Math	@diplodoc/latex-extension
html	HTML-блоки	@diplodoc/html-extension

Плагины включены в сборку бандла. Включите нужные в конфиге (plugins.latex: true и т.д.).

LaTeX: в редакторе нажмите / — в меню появятся «Inline math» и «Block math».

После изменения конфига обязательно:

php bin/console cache:clear

Проверка: php bin/console debug:config attuladzan_markdown_editor — в выводе должно быть plugins: { latex: true }.

Использование

Symfony Form

use Attuladzan\MarkdownEditorBundle\Form\MarkdownEditorType;

$builder->add('content', MarkdownEditorType::class, [
    'editor_options' => ['allow_html' => true],
]);

Twig

{{ gravity_markdown_editor({ name: 'content', value: content }) }}

EasyAdmin 5

use Attuladzan\MarkdownEditorBundle\EasyAdmin\Field\MarkdownEditorField;

yield MarkdownEditorField::new('content');

Добавьте form theme в CrudController:

->addFormTheme('@AttuladzanMarkdownEditor/Form/attuladzan_markdown_editor_widget.html.twig');

Опционально для превью markdown:

composer require easycorp/easyadmin-bundle twig/extra-bundle

Лицензия

MIT