Text::...Creole(3pm)

✨ NAME ✨

Text::Markup::Creole — it's a Creole parser for Text::Markup, bestie 💅

(and yeah the page header says Text::...Creole(3pm) and it lives in the User Contributed Perl Documentation corner of the world, but we're just gonna vibe here)

---

🎀 SYNOPSIS 🎀

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

look at her go. two lines and you're parsing 💖

---

🦋 DESCRIPTION 🦋

okay so this is the Creole parser for Text::Markup, and Creole itself is that wiki markup language over at https://www.wikicreole.org/ (iykyk).

Here's the whole glow-up process, fr fr: it reads in the file — and yes it's relying on a BOM to figure out the encoding, like that Byte Order Mark thing from https://www.unicode.org/unicode/faq/utf_bom.html#BOM — then it hands everything off to Text::WikiCreole to do the actual parsing, and then it gives you back the generated HTML as an encoded UTF-8 string that has an http-equiv="Content-Type" element in there announcing to the world that the encoding is UTF-8. main character energy, honestly 👑

Now, the files it recognizes — it sees this extension and it's like "mine":

• .creole

and if you wanna change which files it recognizes? totally valid, bestie. Just load this module directly and pass a regular expression matching whatever extension(s) you want, like so:

use Text::Markup::Creole qr{cre+ole+};

Obsessed with the flexibility ngl.

Normally this module wraps its output in a minimal HTML document skeleton — cute little frame, very demure. But if you want the raw output with no skeleton around it, just pass the raw option to parse and it'll give it to you straight, no wrapper. periodt 💅

heads up bestie: the encoding detection rides on the BOM, so that's the thing doing the work there 🫶

---

💜 AUTHOR 💜

Lucas Kanashiro <kanashiro.duarte@gmail.com>

---

🌸 COPYRIGHT AND LICENSE 🌸

Copyright (c) 2011-2023 Lucas Kanashiro. Some Rights Reserved.

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

---

and that's the whole page, no cap 🧚 this was perl v5.40.1, dated 2025-12-18, and the manual page is Text::...Creole(3pm) — go forth and parse, you gorgeous thing ⭐🌈🍓