podlite-markuplisted

# Podlite Markup Podlite is a lightweight markup language for documentation, knowledge bases, and structured content. It extends Markdown concepts with explicit block boundaries, typed attributes, and rich inline formatting. - **Extension:** `.podlite` - **Document root:** `=begin pod ... =end pod` - **Every directive** starts with `=` as first non-whitespace on its line - **Full specification:** https://podlite.org/specification ## Block forms Every block type supports three equivalent forms: ``` =head1 Title abbreviated (one line) =for head1 :attr<val> paragraph (content until blank line) Title text =begin head1 :attr<val> delimited (explicit =end) Title text =end head1 ``` ## Block types | Block | Purpose | Example | |-------|---------|---------| | `=head1`..`=head4` | Headings | `=head1 Introduction` | | `=para` | Explicit paragraph | `=begin para :tags<ai>` | | `=item` | List item (`=item` = `=item1`) | `=item First point` | | `=item1`/`=item2`/`=item3` | Nested lists (no level skip) | `=item2 Sub-point` | | `=code` | Code block (verbatim) | `=begin code :lang<js>` | | `=table` | Data table | `=begin table :caption('Title')` | | `=data-table` | Render CSV/TSV (inline, `:src<file:…>`, or `:src<data:…>`) | `=for data-table :src<file:./planets.csv>` | | `=comment` | Not rendered | `=begin comment` | | `=nested` | Indented/nested content | `=begin nested :notify<warning>` | | `=pict