Markde...kParser(3pm)

💅 Markdent::Role::BlockParser — bestie edition

okay so this is a page from the User Contributed Perl Documentation, and it's all about Markdent::Role::BlockParser, a Perl role. come sit with me, we're gonna get through this together 🫶

---

🌸 NAME 🌸

Markdent::Role::BlockParser — it's literally a role for block parsers. that's the whole thing. iconic.

---

✨ VERSION ✨

version 0.40 — that's the one, babes 🎀

---

💖 DESCRIPTION 💖

so this role is the shared-glow-up situation: it implements the behavior that all block parsers have in common. every block parser gets this vibe. no cap. ✨

---

👑 REQUIRED METHODS 👑

if you're gonna be a block parser, you must show up with this. non-negotiable, bestie.

• $parse->parse_document(\$text) — okay so this method takes a scalar reference to a markdown document (yes, a reference, a \$text situation) and parses it for block-level markup. that's the job. that's what it does. periodt. 💅

---

🦋 ATTRIBUTES 🦋

this role provides the following attributes, and yes they're cute:

_span_parser

• it's a read-only attribute, so look but don't touch, bestie 🙈
• it's an object that does the Markdent::Role::SpanParser role — so it's a span parser doing span parser things
• it is required for all block parsers. like, every single one. no exceptions. if you don't have it, you're not valid, and that's on periodt 🌈

---

🧚 ROLES 🧚

this role is doing the most and honestly we love that for it — it does the Markdent::Role::AnyParser and Markdent::Role::DebugPrinter roles. main character energy fr fr 🔥

---

💀 BUGS 💀

not me having to tell you where to report bugs, but here we are:

• see Markdent for the bug reporting details, k?
• bugs may be submitted at <https://github.com/houseabsolute/Markdent/issues> — go off, tell them everything 🍓
• also! the author is usually active on IRC as autarch on irc://irc.perl.org — so if you wanna slide into those DMs (the IRC kind), you absolutely can 💜

---

⭐ SOURCE ⭐

the source code repository for Markdent can be found at <https://github.com/houseabsolute/Markdent>. go look, it's giving open source excellence 🌈

---

🌸 AUTHOR 🌸

Dave Rolsky <autarch@urth.org> — the icon, the legend, the author 💖

---

🎀 COPYRIGHT AND LICENSE 🎀

okay legal era, let's get into it:

• this software is copyright (c) 2021 by Dave Rolsky 👑
• it's free software — you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. so, like, go wild, but respectfully 🫶
• the full text of the license can be found in the LICENSE file included with this distribution. read it, bestie, it's there for you 📜

---

this page came to you courtesy of perl v5.32.1, dated 2021-08-31 — and with that, we're done here. mwah, love u, bye 💋✨