Markde...:Theory(3pm)

📦
version 0.40 · 2 versions
, in debian bookworm, ubuntu jammy, ubuntu noble

💖 NAME 💖

Markde...:Theory — it's the Markdown extensions that David Wheeler (aka Theory) proposed, and honestly? slay. 👑

✨ SYNOPSIS ✨

okay so bestie, here's the vibe:

use Markdent::Parser;

my $parser = Markdent::Parser->new( dialects => 'Theory', handler => ... );

that's it. that's the whole entrance. 🎀

🦋 DESCRIPTION 🦋

so the Theory roles add parsing for Markdown extensions that David Wheeler (aka Theory) came up with. no cap. for the deets, go look at:

🌸 DEVIATIONS 🌸

okay so this dialect does NOT match David Wheeler's proposals 100%. it differs in a few ways. most of these deviations were literally discussed with David Wheeler and included with his approval — we're not just out here freelancing 💅

  • The header's "marker" row can use +====+ as well as +----+:
| Header 1 | Header 2 |
+==========+==========+
| Body 1   | Body 2   |
  • The table does not require a header:
| Body 1 | Body 2 |
| Body 3 | Body 4 |
  • You can include a header marker at the beginning and/or end of the table. this matches how MySQL outputs tables from its CLI tool:
+------+-------------+------------------------------+--------+
| id   | name        | description                  | price  |
+------+-------------+------------------------------+--------+
|    1 | gizmo       | Takes care of the doohickies |   1.99 |
|    2 | doodad      | Collects *gizmos*            |  23.80 |
|   10 | dojigger    | Foo                          | 102.98 |
| 1024 | thingamabob | Self-explanatory, no?        |   0.99 |
+------+-------------+------------------------------+--------+
  • Currently it just does tables, not definition lists. this will be fixed in a future release. (not yet bestie, not yet 😭)
  • Table continuation lines are expected to have the same number of cells as the line being continued. in other words, this does NOT work:
| cell1 | cell2     |
        : continues

Instead, you must write this:

| cell1 | cell2     |
:       : continues :
Heads up!! This is not an approved deviation, and it may get corrected in a future release if I can figure out how to do so. (patches welcome) 🫶

💀 BUGS 💀

See Markdent for bug reporting details. (go tell the main character, not me 🙈)

👑 AUTHOR 👑

Dave Rolsky, <autarch@urth.org>

Copyright 2009-2012 Dave Rolsky, All Rights Reserved.

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

okay and for the receipts, bestie: this whole thing is running on perl v5.32.1 and the page is dated 2021-08-31, from the User Contributed Perl Documentation collection — Markde...:Theory(3pm), iconic, no notes. 🎀✨💖

📦 where this page comes from