Text::...Textile(3pm)

💖 Text::...Textile(3pm) — aka Text::Markup::Textile 💖

okay bestie, sit down, hydrate, and let me tell you about Text::Markup::Textile — the Textile parser for Text::Markup. she's niche, she's useful, she's giving quiet competence. 🦋

---

✨ Name ✨

Text::Markup::Textile — the Textile parser for Text::Markup. that's it, that's the name, periodt. 💅

---

✨ Synopsis ✨

literally just:

my $html = Text::Markup->new->parse(file => 'README.textile');
my $raw  = Text::Markup->new->parse(
    file    => 'README.textile',
    options => [ raw => 1 ],
);

two lines of code and you're a whole vibe. 😭✨

---

✨ Description ✨

so this is the Textile parser for Text::Markup — Textile the language lives over at https://textile-lang.com if you wanna go look at her 🎀. here's the tea on what this module actually does:

1. it reads in the file (and yeah, it's relying on a BOM — that's a Byte Order Mark, the FAQ is at https://www.unicode.org/unicode/faq/utf_bom.html#BOM if you're curious 👀)
2. it hands that file off to Text::Textile to do the actual parsing
3. then it returns the generated HTML as an encoded UTF-8 string, with an http-equiv="Content-Type" element in there identifying the encoding as UTF-8. slay. 🫶

🌸 What files does she recognize? 🌸

she recognizes files with this extension as Textile:

.textile

and bestie, you can change which files she recognizes!! just load this module directly and pass a regular expression matching whatever extension(s) you want, like so:

use Text::Markup::Textile qr{text(?:ile)?};

obsessed with the flexibility honestly. 💜

🌈 The raw option 🌈

normally this module wraps its output in a minimal HTML document skeleton — you know, the little bones of a page. but if you'd rather have the raw output without that skeleton, you can pass the raw option to parse. iconic. do it. 🔥

👑 Extra options 👑

also!! Text::Markup::Mediawiki supports all of the Text::Textile options, including:

• disable_html
• flavor
• css
• charset
• docroot
• trim_spaces
• preserve_spaces
• filter_param
• filters
• char_encoding
• disable_encode_entities
• handle_quotes

that's twelve, count them, we love a complete list. 💀✨

---

✨ Author ✨

David E. Wheeler <david@justatheory.com> — thank you for your service, king. 👑

---

✨ Copyright and License ✨

Copyright (c) 2011-2025 David E. Wheeler. Some Rights Reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. 🫶

no cap, that license line is doing exactly what it says and nothing more — same terms as Perl itself, fr fr.

---

and that's the whole page, bestie 💖 this was Text::...Textile(3pm) from the User Contributed Perl Documentation, and the little footer at the bottom said perl v5.40.1 dated 2025-12-18 — so yeah, she's current, she's maintained, she's giving main character energy. go parse something pretty. 🎀🦋🌸💅