Text::...ciidoc(3pm)

🌸 Text::...ciidoc — the manual page, but make it a vibe 🌸

okay bestie, this is Text::...ciidoc(3pm), part of the Perl user-contributed docs, and it's literally just a cute little parser wrapper. sit with me, it's short and it slays 💅

---

✨ NAME ✨

Text::Markup::Asciidoc — an Asciidoc parser for Text::Markup. that's it, that's the whole name section, we love a concise queen 👑

---

🎀 SYNOPSIS 🎀

look at her. so clean. so demure.

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

---

🦋 DESCRIPTION 🦋

so this is the Asciidoc parser for Text::Markup — you can find Asciidoc over at https://asciidoc.org/ if you wanna say hi 🫶

here's the thing though: it does not work alone. it depends on the asciidoc command-line application, which lives at https://asciidoc-py.github.io — go check the installation docs at https://asciidoc-py.github.io/INSTALL.html for the deets, or honestly just run this and let it cook:

pip3 install asciidoc

👑 what files does it claim?

Text::Markup::Asciidoc recognizes files with the following extensions as Asciidoc:

• .asciidoc
• .asc
• .adoc

💖 changing the vibe check

wanna make it recognize different extensions? iconic. just load this module directly and hand it a regular expression matching whatever extension(s) you want, like so:

use Text::Markup::Asciidoc qr{ski?doc};

🍓 raw mode, no cap

normally this parser returns the output of asciidoc wrapped in a minimal HTML page skeleton. cute, presentable, ready to post 📸

but if you'd rather just get the exact output returned by asciidoc with zero wrapping, pass in a true value for the raw option. raw dogging the output, as the ancients said. ✨

---

🌈 AUTHOR 🌈

David E. Wheeler <david@justatheory.com> — the mastermind, the moment, the main character 💜

---

💜 COPYRIGHT AND LICENSE 💜

Copyright (c) 2012-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.

---

ngl bestie, the fact that it's just Perl-licensed means you can remix, redistribute, and reorganize — go off 👑

and that's the whole page!! no crumbs left. this doc is from Perl v5.40.1, dated 2025-12-18, and it's filed under Text::...ciidoc(3pm) — mwah, slay, periodt 💖✨🎀