dg / texy

v3.2.8 2026-02-23 02:30 UTC

Requires

• php: 8.1 - 8.5

Requires (Dev)

• latte/latte: ^3.0.14
• nette/phpstan-rules: ^1.0
• nette/tester: ^2.5
• phpstan/extension-installer: ^1.4@stable
• phpstan/phpstan: ^2.1@stable
• tracy/tracy: ^2.9

Conflicts

• latte/latte: >=3.0.0 <3.0.14

Replaces

• dg/texy: *

BSD-3-Clause, GPL-2.0-only, GPL-3.0-only

• David Grudl

• text
• markdown
• html
• texy
• wiki
• plain text
• markup language
• textile

Published on Packagist.org on 2026-02-23 02:30 UTC

README

Texy is a text-to-HTML engine for lightweight markup languages, written in PHP. It turns human-readable plain text into structurally valid HTML – complete with images, links, nested lists, and tables – no knowledge of HTML required.

Above all, Texy is an engine. It ships with its own rich, easy-to-read markup, but nothing about that syntax is set in stone: every rule can be switched on or off, redefined, or extended with your own. You can reshape Texy to speak a different dialect entirely – and one of them already exists, see Markdown below.

And Texy is a typographer at heart. It swaps straight quotes for typographically correct ones, hyphens for dashes, the letter x for the dimension sign, and applies many more refinements so your text reads like it was professionally typeset.

Install Texy via Composer:

composer require texy/texy

Texy requires PHP 8.2 or higher.

Usage

$texy = new Texy;
$html = $texy->process($text);

For untrusted input, always enable safe mode, which restricts the output to a safe subset of HTML:

Texy\Configurator::safeMode($texy);
$html = $texy->process($text);

Markdown

texy/markdown is a companion package that parses CommonMark and GitHub Flavored Markdown – the whole specification, all five extensions – into this same AST:

composer require texy/markdown

$markdown = Texy\Markdown\Markdown::gfm();
$html = $markdown->toHtml($text, $texy);

Because the tree is the same one, a Markdown document goes out through the renderer above and gets everything Texy does to a Texy one: typography, HTML sanitization, well-forming, Latte integration. The package renders a Texy AST back to Markdown as well, so converting between the two languages is a matter of picking a parser and a renderer.

Documentation and Examples

The full manual is on the homepage https://texy.deegee.dev. The docs/ directory holds the reference for using and extending Texy:

• Syntax reference – complete reference of the Texy markup language, including syntaxes that are disabled by default
• Configuration – all configuration options, the Configurator presets, and security (safe mode)
• Custom handlers – changing the behavior of existing constructs via renderer handlers and AST passes
• Custom syntax – adding brand-new markup constructs
• Upgrading – migration guide from Texy 3

The examples/ directory contains ready-to-run demos.

Support Me

Do you like Texy? Are you looking forward to the new features?

Thank you!