apex-ruby 1.0.18 → 1.0.20

data/ext/apex_ext/apex_src/README.md

@@ -1,5 +1,5 @@
 
-[![Version: 1.0.3](https://img.shields.io/badge/Version-1.0.3-528c9e)](https://github.com/ApexMarkdown/apex/releases/latest) ![](https://img.shields.io/badge/CMake-064F8C?style=for-the-badge&logo=cmake&logoColor=white) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) <!--TESTS_BADGE-->![Tests passing 1502/1502](https://img.shields.io/badge/Tests-1502/1502-a5da78)<!--END TESTS_BADGE-->
+[![Version: 1.1.17](https://img.shields.io/badge/Version-1.1.17-528c9e)](https://github.com/ApexMarkdown/apex/releases/latest) ![](https://img.shields.io/badge/CMake-064F8C?style=for-the-badge&logo=cmake&logoColor=white) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) <!--TESTS_BADGE-->![Tests passing 0/2003](https://img.shields.io/badge/Tests-0/2003-f97373)<!--END TESTS_BADGE-->
 
 
 # Apex
@@ -21,22 +21,41 @@ flavor. So I'm building Apex with the goal of making all of
 the most popular features of various processors available in
 one tool.
 
+## Table of Contents
+
+- [Features](#features)
+  - [Compatibility Modes](#compatibility-modes)
+  - [Markdown Extensions](#markdown-extensions)
+  - [Document Features](#document-features)
+  - [Citations and Bibliography](#citations-and-bibliography)
+  - [Indices](#indices)
+  - [Critic Markup](#critic-markup)
+  - [Output Options](#output-options)
+  - [Advanced Features](#advanced-features)
+  - [Extensibility and Plugins](#extensibility-and-plugins)
+- [Installation](#installation)
+- [Basic Usage](#basic-usage)
+- [Documentation](#documentation)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Features
 
 ### Compatibility Modes
 
-- **Multiple compatibility modes**: CommonMark, GFM, MultiMarkdown, Kramdown, and Unified (all features)
-- **Mode-specific features**: Each mode enables appropriate extensions for maximum compatibility
+- **Multiple compatibility modes**: [CommonMark, GFM, MultiMarkdown, Kramdown, and Unified](https://github.com/ApexMarkdown/apex/wiki/Modes) (all features)
+- **Mode-specific features**: Each mode enables appropriate extensions for maximum compatibility ([more info](https://github.com/ApexMarkdown/apex/wiki/Modes))
 
 ### Markdown Extensions
 
-- **Tables**: GitHub Flavored Markdown tables with advanced features (rowspan via `^^`, colspan via empty cells/`<<`, captions before/after tables including Pandoc-style `Table: Caption` and `: Caption` syntax, and individual cell alignment using colons `:Left`, `Right:`, `:Center:`)
+- **Tables**: [GitHub Flavored Markdown tables](https://github.com/ApexMarkdown/apex/wiki/Tables) with advanced features (rowspan via `^^`, colspan via empty cells/`<<`, captions before/after tables including Pandoc-style `Table: Caption` and `: Caption` syntax, and individual cell alignment using colons `:Left`, `Right:`, `:Center:`)
+- **Grid tables**: Pandoc-style `+---+` grid tables (opt-in with `--grid-tables`; [more info](https://github.com/ApexMarkdown/apex/wiki/Tables#grid-tables-pandoc-style))
 - **Table caption positioning**: Control caption placement with `--captions above` or `--captions below` (default: below)
 - **Table caption IAL**: IAL attributes in table captions (e.g., `: Caption {#id .class}`) are extracted and applied to the table element
 - **Relaxed tables**: Support for tables without separator rows (Kramdown-style)
 - **Headerless tables**: Support for tables that start with alignment rows (separator rows) without header rows; column alignment is automatically applied
-- **Footnotes**: Three syntaxes supported (reference-style, Kramdown inline, MultiMarkdown inline)
-- **Definition lists**: Kramdown-style definition lists with Markdown content support
+- **Footnotes**: Three syntaxes supported (reference-style, Kramdown inline, MultiMarkdown inline) ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
+- **Definition lists**: Kramdown-style definition lists with Markdown content support ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
 - **Task lists**: GitHub-style checkboxes (`- [ ]` and `- [x]`)
 - **Strikethrough**: `~~text~~` syntax from GFM
 - **Smart typography**: Automatic conversion of quotes, dashes, ellipses, and more
@@ -44,51 +63,53 @@ one tool.
 
 - **Syntax highlighting**: External syntax highlighting for fenced code blocks via Pygments, Skylighting, or Shiki with `--code-highlight` flag.
 
-  Supports language-aware highlighting, auto-detection, and line numbers with `--code-line-numbers`
+  Supports language-aware highlighting, auto-detection, and line numbers with `--code-line-numbers` ([more info](https://github.com/ApexMarkdown/apex/wiki/Command-Line-Options))
 
-- **Wiki links**: `[[Page Name]]`, `[[Page Name|Display Text]]`, and `[[Page Name#Section]]` syntax with configurable link targets via `--wikilink-space` and `--wikilink-extension`
+- **Wiki links**: `[[Page Name]]`, `[[Page Name|Display Text]]`, and `[[Page Name#Section]]` syntax with configurable link targets via `--wikilink-space` and `--wikilink-extension` ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
 - **Abbreviations**: Three syntaxes (classic MMD, MMD 6 reference, MMD 6 inline)
-- **Callouts**: Bear/Obsidian-style callouts with collapsible support (`> [!NOTE]`, `> [!WARNING]`, etc.)
+- **Callouts**: Bear/Obsidian-style callouts with collapsible support (`> [!NOTE]`, `> [!WARNING]`, etc.), plus optional Python-Markdown (`!!!`) and Quarto (`:::`) callout parsing behind explicit flags ([more info](https://github.com/ApexMarkdown/apex/wiki/Callouts))
 - **GitHub emoji**: 350+ emoji support (`:rocket:`, `:heart:`, etc.)
 
 ### Document Features
 
 
 
-- **Metadata blocks**: YAML front matter, MultiMarkdown metadata, and Pandoc title blocks
-- **Metadata variables**: Insert metadata values with `[%key]` syntax
+- **Metadata blocks**: YAML front matter, MultiMarkdown metadata, and Pandoc title blocks ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
+- **Metadata variables**: Insert metadata values with `[%key]` syntax ([more info](https://github.com/ApexMarkdown/apex/wiki/Configuration))
 - **Metadata transforms**: Transform metadata values with `[%key:transform]` syntax
 
   Supports case conversion, string manipulation, regex replacement, date formatting, and more.
 
   See [Metadata Transforms](https://github.com/ApexMarkdown/apex/wiki/Metadata-Transforms) for complete documentation
-- **Metadata control of options**: Control command-line options via metadata
+- **Metadata control of options**: [Control command-line options via metadata](https://github.com/ApexMarkdown/apex/wiki/Configuration)
   - set boolean flags (`indices: false`, `wikilinks: true`) and string options (`bibliography: refs.bib`, `title: My Document`, `wikilink-space: dash`, `wikilink-extension: html`) directly in document metadata for per-document configuration
-- **Table of Contents**: Automatic TOC generation with depth control using HTML (`<!--TOC-->`), MMD (`{{TOC}}` / `{{TOC:2-4}}`), and Kramdown `{:toc}` markers. Headings marked with `{:.no_toc}` are excluded from the generated TOC.
-- **File includes**: Three syntaxes (Marked `<<[file]`, MultiMarkdown `{{file}}`, iA Writer `/file`), with support for address ranges and wildcard/glob patterns such as `{{file.*}}`, `{{*.md}}`, and `{{c?de.py}}`.
+- **Table of Contents**: Automatic TOC generation with depth control using HTML (`<!--TOC-->`), MMD (`{{TOC}}` / `{{TOC:2-4}}`), and Kramdown `{:toc}` markers. Headings marked with `{:.no_toc}` are excluded from the generated TOC. ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
+- **File includes**: Three syntaxes (Marked `<<[file]`, MultiMarkdown `{{file}}`, iA Writer `/file`), with support for address ranges and wildcard/glob patterns such as `{{file.*}}`, `{{*.md}}`, and `{{c?de.py}}`. ([more info](https://github.com/ApexMarkdown/apex/wiki/Multi-File-Documents))
 - **Markdown combiner (`--combine`)**: Concatenate one or more Markdown files into a single Markdown stream, expanding all include syntaxes.
 
-  When a `SUMMARY.md` file is provided, Apex treats it as a GitBook-style index and combines the linked files in order, perfect for building books, multi-file indices, and shared tables of contents that can then be piped back into Apex for final rendering.
+  When a `SUMMARY.md` file is provided, Apex treats it as a GitBook-style index and combines the linked files in order, perfect for building books, multi-file indices, and shared tables of contents that can then be piped back into Apex for final rendering. ([more info](https://github.com/ApexMarkdown/apex/wiki/Multi-File-Documents))
 - **MultiMarkdown merge (`--mmd-merge`)**: Read one or more mmd_merge-style index files and stitch their referenced documents into a single Markdown stream.
 
   Each non-empty, non-comment line specifies a file to include; indentation with tabs or four-space groups shifts all headings in that file down by one level per indent, mirroring the original `mmd_merge.pl` behavior.
 
-  Output is raw Markdown that can be piped into Apex (e.g., `apex --mmd-merge index.txt | apex --mode mmd`).
+  Output is raw Markdown that can be piped into Apex (e.g., `apex --mmd-merge index.txt | apex --mode mmd`). ([more info](https://github.com/ApexMarkdown/apex/wiki/Multi-File-Documents))
 
-- **CSV/TSV support**: Automatic table conversion from CSV and TSV files
-- **Inline Attribute Lists (IAL)**: Kramdown-style attributes `{: #id .class}` and Pandoc-style attributes `{#id .class}`
+- **CSV/TSV support**: Automatic table conversion from CSV and TSV files ([more info](https://github.com/ApexMarkdown/apex/wiki/Tables))
+- **Inline Attribute Lists (IAL)**: [Kramdown-style attributes](https://github.com/ApexMarkdown/apex/wiki/Inline-Attribute-Lists) `{: #id .class}` and Pandoc-style attributes `{#id .class}`
 
   Both formats work in all contexts (block-level, inline, paragraphs, headings, table captions)
-- **Bracketed spans**: Convert `[text]{IAL}` syntax to HTML span elements with attributes, enabled by default in unified mode
+- **Bracketed spans**: Convert `[text]{IAL}` syntax to HTML span elements with attributes, enabled by default in unified mode ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
 - **Fenced divs**: Pandoc-style fenced divs `::::: {#id .class} ... :::::` for creating custom block containers, enabled by default in unified mode.
 
-  Supports block type syntax `>blocktype` to create different HTML elements (e.g., `::: >aside {.sidebar}` creates `<aside>` instead of `<div>`). Common block types include `aside`, `article`, `section`, `details`, `summary`, `header`, `footer`, `nav`, and custom elements
-- **Image IAL support**: Inline and reference-style images support IAL syntax with automatic width/height conversion (percentages and non-integer/non-px values convert to style attributes, Xpx values convert to integer width/height attributes, bare integers remain as width/height attributes)
+  Supports block type syntax `>blocktype` to create different HTML elements (e.g., `::: >aside {.sidebar}` creates `<aside>` instead of `<div>`). Common block types include `aside`, `article`, `section`, `details`, `summary`, `header`, `footer`, `nav`, and custom elements ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
+- **Image IAL support**: Inline and reference-style images support IAL syntax with automatic width/height conversion (percentages and non-integer/non-px values convert to style attributes, Xpx values convert to integer width/height attributes, bare integers remain as width/height attributes) ([more info](https://github.com/ApexMarkdown/apex/wiki/Multi-Format-Images))
 - **Special markers**: Page breaks (`<!--BREAK-->`), autoscroll pauses (`<!--PAUSE:N-->`), end-of-block markers
 
 
 ### Citations and Bibliography
 
+See the [Citations and Bibliography](https://github.com/ApexMarkdown/apex/wiki/Citations) wiki page for a complete guide.
+
 - **Multiple citation syntaxes**: Pandoc (`[@key]`), MultiMarkdown (`[#key]`), and mmark (`[@RFC1234]`) styles
 - **Bibliography formats**: Support for BibTeX (`.bib`), CSL JSON (`.json`), and CSL YAML (`.yml`, `.yaml`) formats
 - **Automatic bibliography generation**: Bibliography automatically generated from cited entries
@@ -100,6 +121,8 @@ one tool.
 
 ### Indices
 
+See the [Indices](https://github.com/ApexMarkdown/apex/wiki/Indices) wiki page for syntax and examples.
+
 - **mmark syntax**: `(!item)`, `(!item, subitem)`, `(!!item, subitem)` for primary entries
 - **TextIndex syntax**: `{^}`, `[term]{^}`, `{^params}` for flexible indexing
 - **Automatic index generation**: Index automatically generated at end of document or at `<!--INDEX-->` marker
@@ -109,7 +132,7 @@ one tool.
 
 ### Critic Markup
 
-- **Change tracking**: Additions (`{++text++}`), deletions (`{--text--}`), substitutions (`{~~old~>new~~}`)
+- **Change tracking**: Additions (`{++text++}`), deletions (`{--text--}`), substitutions (`{~~old~>new~~}`) ([more info](https://github.com/ApexMarkdown/apex/wiki/Syntax))
 - **Annotations**: Highlights (`{==text==}`) and comments (`{>>text<<}`)
 - **Accept mode**: `--accept` flag to apply all changes for final output
 - **Reject mode**: `--reject` flag to revert all changes to original
@@ -121,11 +144,13 @@ one tool.
 - **Custom styling**: Link multiple external CSS files in standalone mode (use `--css` multiple times or comma-separated list)
 - **Syntax highlighting**: External syntax highlighting via Pygments, Skylighting, or Shiki with `--code-highlight` flag, includes automatic GitHub-style CSS in standalone mode
 - **Pretty-print**: Formatted HTML with proper indentation for readability
-- **XHTML output**: `--xhtml` writes void/empty elements in XML form (`<br />`, `<meta ... />`). `--strict-xhtml` adds polyglot XHTML document scaffolding when used with `--standalone` (XML declaration, XHTML namespace, `Content-Type` meta). You can also select the same behavior with `-t xhtml` or `-t strict-xhtml` (aliases for HTML output with those flags). In **fragment** mode, strict mode does not validate or repair all markup as XML???raw HTML can still be ill-formed; see the main README.
-- **Header ID generation**: Automatic or manual header IDs with multiple format options (GFM, MMD, Kramdown)
+- **XHTML output**: `--xhtml` writes void/empty elements in XML form (`<br />`, `<meta ... />`). `--strict-xhtml` adds polyglot XHTML document scaffolding when used with `--standalone` (XML declaration, XHTML namespace, `Content-Type` meta). You can also select the same behavior with `-t xhtml` or `-t strict-xhtml` (aliases for HTML output with those flags). In **fragment** mode, strict mode does not validate or repair all markup as XML; raw HTML can still be ill-formed.
+- **Header ID generation**: [Automatic or manual header IDs](https://github.com/ApexMarkdown/apex/wiki/Header-IDs) with multiple format options (GFM, MMD, Kramdown)
 - **Emoji-to-name conversion**: In GFM mode, emojis in headers are converted to their textual names in IDs (e.g., `# ???? Support` ??? `id="smile-support"`), matching Pandoc's GFM behavior
 - **Header anchors**: Option to generate `<a>` anchor tags instead of header IDs
 - **ARIA accessibility**: Add ARIA labels and accessibility attributes (`--aria`) for better screen reader support, including aria-label on TOC navigation, role attributes on figures and tables, and aria-describedby linking tables to their captions
+- **Terminal output**: Render Markdown in the terminal with `-t terminal` / `-t terminal256`, themes, pagination, and optional inline images ([more info](https://github.com/ApexMarkdown/apex/wiki/Rendering-Markdown-In-Terminal))
+- **RTF output**: Native Rich Text Format via `-t rtf` (files and `NSAttributedString`); see clipboard notes in [Command Line Options](https://github.com/ApexMarkdown/apex/wiki/Command-Line-Options)
 - **Terminal inline images**: With `-t terminal` / `-t terminal256`, when stdout is a TTY and a viewer is available on `PATH`, Markdown images are rendered as inline terminal graphics (viewer order: `imgcat`, `chafa`, `viu`, `catimg`). Width is controlled with `--terminal-image-width` (default 50 character cells). HTTP(S) URLs are downloaded with `curl` (60s timeout, 10 MiB max) to a temp file under `TMPDIR` or `/tmp`. Use `--no-terminal-images` to always show images as styled link text plus URL instead. Metadata: `terminal.inline_images` / `terminal_inline_images`, `terminal.image_width` / `terminal_image_width`.
 
 ### Advanced Features
@@ -155,10 +180,14 @@ When installing from a direct Git URL or GitHub repo name,
 Apex will prompt with a security warning before cloning,
 since plugins execute unverified code.
 
-For a complete guide to writing, installing, and publishing plugins, see the [Plugins](https://github.com/ApexMarkdown/apex/wiki/Plugins) page in the Apex Wiki.
+For a complete guide to writing, installing, and publishing plugins, see the [Plugins](https://github.com/ApexMarkdown/apex/wiki/Plugins) page in the Apex Wiki. App developers can also use the [plugin catalog API](https://github.com/ApexMarkdown/apex/wiki/Xcode-Integration#plugin-catalog-and-installation) from Swift or Objective-C ([C API](https://github.com/ApexMarkdown/apex/wiki/C-API#plugin-catalog-api)).
+
+**AST filters** (Pandoc-style JSON filters) are also supported via `--filter`, `--filters`, and `--lua-filter`. See [Filters](https://github.com/ApexMarkdown/apex/wiki/Filters).
 
 ## Installation
 
+See the [Installation](https://github.com/ApexMarkdown/apex/wiki/Installation) wiki page for additional build options and platform notes.
+
 ### Homebrew (macOS/Linux)
 
 ```bash
@@ -197,6 +226,8 @@ Download pre-built binaries from the [latest release](https://github.com/ApexMar
 
 ## Basic Usage
 
+See [Usage](https://github.com/ApexMarkdown/apex/wiki/Usage) and [Getting Started](https://github.com/ApexMarkdown/apex/wiki/Getting-Started) for more examples.
+
 ### Command Line
 
 ```bash
@@ -216,7 +247,7 @@ apex input.md --pretty
 
 ### Processing Modes
 
-Apex supports multiple compatibility modes:
+Apex supports multiple [compatibility modes](https://github.com/ApexMarkdown/apex/wiki/Modes):
 
 - `--mode commonmark` - Pure CommonMark specification
 - `--mode gfm` - GitHub Flavored Markdown
@@ -237,6 +268,8 @@ apex input.md --mode kramdown
 
 ### Common Options
 
+See [Command Line Options](https://github.com/ApexMarkdown/apex/wiki/Command-Line-Options) for the full reference.
+
 - `--pretty` - Pretty-print HTML with indentation
 
 `--standalone` - Generate complete HTML document with `<html>`, `<head>`, `<body>`
@@ -292,6 +325,10 @@ apex input.md --mode kramdown
 
   syntax (enabled by default in unified mode)
 
+- `--py-callouts` / `--no-py-callouts` - Enable/disable Python-Markdown callout syntax (`!!!`) plus markdown-callouts label syntax (`NOTE: ...`, `>? NOTE: ...`) (disabled by default)
+
+- `--quarto-callouts` / `--no-quarto-callouts` - Enable/disable Quarto `:::` callout syntax for `.callout-*` blocks (disabled by default; recognized callouts bypass generic div processing)
+
 `--spans` / `--no-spans` - Enable/disable bracketed spans `[text]{IAL}` syntax (enabled by default in unified mode)
 
 `--code-highlight TOOL` - Use external tool for syntax highlighting (supports `pygments`/`p`/`pyg`, `skylighting`/`s`/`sky`, or `shiki`/`sh`). Uses HTML or ANSI output based on destination format. Automatically includes GitHub-style CSS in standalone mode
@@ -301,7 +338,7 @@ apex input.md --mode kramdown
 ### All Options
 
 ```
-Apex Markdown Processor v1.0.3
+Apex Markdown Processor v1.1.17
 One Markdown processor to rule them all
 
 Project homepage: https://github.com/ApexMarkdown/apex
@@ -325,6 +362,7 @@ Options:
   --combine              Concatenate Markdown files (expanding includes) into a single Markdown stream
                          When a SUMMARY.md file is provided, treat it as a GitBook index and combine
                          the linked files in order. Output is raw Markdown suitable for piping back into Apex.
+  --concordance FILE      TextIndex concordance TSV file (can be used multiple times; enables indices)
   --csl FILE              Citation style file (CSL format)
   --css FILE, --style FILE  Link to CSS file(s) in document head. With HTML: requires -s/--standalone.
                          With -t man-html -s: include custom CSS in the man page. Can be used multiple times or comma-separated (e.g., --css style.css)
@@ -358,8 +396,8 @@ Options:
   --[no-]mixed-lists     Allow mixed list markers at same level (inherit type from first item)
   --mmd-merge            Merge files from one or more mmd_merge-style index files into a single Markdown stream
                          Index files list document parts line-by-line; indentation controls header level shifting.
-  -m, --mode MODE        Processor mode: commonmark, gfm, mmd, kramdown, unified (default)
-  -t, --to FORMAT        Output format: html (default), xhtml (alias for html + --xhtml), strict-xhtml (alias for html + --strict-xhtml), json (before filters), json-filtered/ast-json/ast (after filters), markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html
+  -m, --mode MODE        Processor mode: commonmark, gfm, mmd, kramdown, unified, quarto (default)
+  -t, --to FORMAT        Output format: html (default), xhtml (alias for html + --xhtml), strict-xhtml (alias for html + --strict-xhtml), json (before filters), json-filtered/ast-json/ast (after filters), markdown/md, mmd, commonmark/cmark, kramdown, gfm, terminal/cli, terminal256, man, man-html, toc, rtf
   --no-bibliography       Suppress bibliography output
   --no-footnotes         Disable footnote support
   --no-ids                Disable automatic header ID generation
@@ -372,6 +410,8 @@ Options:
   --no-smart             Disable smart typography
   --no-sup-sub           Disable superscript/subscript syntax
   --[no-]divs            Enable or disable Pandoc fenced divs (Unified mode only)
+  --[no-]py-callouts     Enable or disable Python-Markdown !!! callout syntax (default: disabled)
+  --[no-]quarto-callouts Enable or disable Quarto ::: {.callout-*} syntax (default: disabled)
   --[no-]one-line-definitions  Enable or disable one-line definition lists (Term :: Definition)
   --[no-]spans           Enable or disable bracketed spans [text]{IAL} (Pandoc-style, enabled by default in unified mode)
   --no-tables            Disable table support
@@ -388,6 +428,7 @@ Options:
   --strict-xhtml         Polyglot XHTML/XML for parsers (xmlns, application/xhtml+xml meta; implies --xhtml). Mutually exclusive with --xhtml. Same as -t strict-xhtml.
   --reject               Reject all Critic Markup changes (revert edits)
   --[no-]relaxed-tables  Enable or disable relaxed table parsing (no separator rows required)
+  --[no-]grid-tables     Enable or disable Pandoc grid table syntax (+---+ borders; disabled by default)
   --[no-]per-cell-alignment  Enable or disable per-cell alignment markers (colons at start/end of cells, enabled by default in unified mode)
   --script VALUE         Inject <script> tags before </body> (standalone) or at end of HTML (snippet).
                           VALUE can be a path, URL, or shorthand (mermaid, mathjax, katex). Can be used multiple times or as a comma-separated list.
@@ -396,6 +437,7 @@ Options:
   --[no-]sup-sub         Enable or disable MultiMarkdown-style superscript (^text^) and subscript (~text~) syntax
   --[no-]strikethrough   Enable or disable GFM-style ~~strikethrough~~ processing
   --title TITLE          Document title (requires --standalone, default: "Document")
+  --toc-min-max MIN,MAX  TOC heading depth (default 1,3) for -t toc and bare HTML TOC markers; marker ranges still override
   --[no-]transforms      Enable or disable metadata variable transforms [%key:transform]
   --[no-]unsafe          Allow or disallow raw HTML in output
   --widont               Prevent short widows in headings by inserting non-breaking spaces between trailing words
@@ -418,6 +460,8 @@ Options:
   --no-terminal-images    Do not render local images via imgcat/chafa/viu/catimg on terminal output
   --terminal-image-width N  Max width/cells for terminal image tools (default: 50)
   -p, --paginate          Page terminal/cli/terminal256 output through a pager (APEX_PAGER, then PAGER, then less -R)
+  --paginate-symbols      Page output and render images as chafa ANSI art (compatible with less -R)
+  --no-paginate           Do not page terminal output (overrides -p and paginate: true in config/metadata)
 
 If no file is specified, reads from stdin.
 
@@ -431,6 +475,8 @@ different settings when processing batches. Boolean options
 accept `true`/`false`, `yes`/`no`, or `1`/`0`
 (case-insensitive). String options use the value directly.
 
+See [Configuration](https://github.com/ApexMarkdown/apex/wiki/Configuration) for the complete list of metadata-controlled options.
+
 **Example:**
 
 ```yaml
@@ -453,11 +499,24 @@ For complete documentation, see the [Apex Wiki](https://github.com/ApexMarkdown/
 
 Key documentation pages:
 
-[Citations and Bibliography](https://github.com/ApexMarkdown/apex/wiki/Citations) - Complete guide to citations and bibliographies
-
-[Command Line Options](https://github.com/ApexMarkdown/apex/wiki/Command-Line-Options) - All CLI flags explained
-
-[Syntax Reference](https://github.com/ApexMarkdown/apex/wiki/Syntax) - Complete syntax reference
+- [Getting Started](https://github.com/ApexMarkdown/apex/wiki/Getting-Started) - Your first steps with Apex
+- [Installation](https://github.com/ApexMarkdown/apex/wiki/Installation) - Build and install options
+- [Usage](https://github.com/ApexMarkdown/apex/wiki/Usage) - Basic usage examples
+- [Syntax](https://github.com/ApexMarkdown/apex/wiki/Syntax) - Complete syntax reference
+- [Modes](https://github.com/ApexMarkdown/apex/wiki/Modes) - Processor compatibility modes
+- [Tables](https://github.com/ApexMarkdown/apex/wiki/Tables) - Table syntax, captions, rowspan/colspan
+- [Callouts](https://github.com/ApexMarkdown/apex/wiki/Callouts) - Callout formats and flags
+- [Command Line Options](https://github.com/ApexMarkdown/apex/wiki/Command-Line-Options) - All CLI flags explained
+- [Configuration](https://github.com/ApexMarkdown/apex/wiki/Configuration) - Metadata-controlled options
+- [Multi-File Documents](https://github.com/ApexMarkdown/apex/wiki/Multi-File-Documents) - `--combine`, `--mmd-merge`, includes
+- [Citations](https://github.com/ApexMarkdown/apex/wiki/Citations) - Citations and bibliographies
+- [Indices](https://github.com/ApexMarkdown/apex/wiki/Indices) - Index generation
+- [Plugins](https://github.com/ApexMarkdown/apex/wiki/Plugins) - Plugin system and recipes
+- [Filters](https://github.com/ApexMarkdown/apex/wiki/Filters) - AST filters
+- [Xcode Integration](https://github.com/ApexMarkdown/apex/wiki/Xcode-Integration) - Swift Package Manager and app integration
+- [C API](https://github.com/ApexMarkdown/apex/wiki/C-API) - Programmatic API
+- [Pandoc Integration](https://github.com/ApexMarkdown/apex/wiki/Pandoc-Integration) - Use Apex with Pandoc
+- [Troubleshooting](https://github.com/ApexMarkdown/apex/wiki/Troubleshooting) - Common issues
 
 ## Contributing
 
@@ -474,4 +533,4 @@ Please note the [tests requirement for new features](https://github.com/ApexMark
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE]([LICENSE](https://github.com/ApexMarkdown/apex/blob/main/LICENSE)) file for details.
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/ApexMarkdown/apex/blob/main/LICENSE) file for details.

data/ext/apex_ext/apex_src/VERSION

@@ -1 +1 @@
-1.0.4
+1.1.20

data/ext/apex_ext/apex_src/apex-debug.log

@@ -0,0 +1,4 @@
+[DEBUG] Detected colon caption: ': Sales Data Q4 2024' (after_table=0, before_table=1, prev_line_was_table_row=0, in_table_section=0)
+[DEBUG] Detected colon caption: ': Quarterly Performance' (after_table=0, before_table=1, prev_line_was_table_row=0, in_table_section=0)
+[DEBUG] Detected colon caption: ': Employee Roster {#employee-table .data-table}' (after_table=0, before_table=1, prev_line_was_table_row=0, in_table_section=0)
+[DEBUG][table_html_postprocess] paragraph before strip checks: 'Table: Travel Statistics'

data/ext/apex_ext/apex_src/apex.code-workspace

@@ -0,0 +1,38 @@
+{
+	"folders": [
+		{
+			"path": "."
+		},
+		{
+			"path": "../apex-ruby"
+		},
+		{
+			"path": "../apex.wiki"
+		},
+		{
+			"path": "../apex-plugin-kbd"
+		},
+		{
+			"path": "../apex-plugin-md-fixup"
+		},
+		{
+			"path": "../apex-plugins"
+		},
+		{
+			"path": "../apex-filters"
+		},
+		{
+			"path": "../apex-filter-delink"
+		},
+		{
+			"path": "../apex-filter-title"
+		},
+		{
+			"path": "../apex-filter-uppercase"
+		},
+		{
+			"path": "../apex-filter-unwrap"
+		}
+	],
+	"settings": {}
+}

data/ext/apex_ext/apex_src/apex.taskpaper

@@ -0,0 +1,12 @@
+Inbox:
+	- Code block containing image markup renders empty
+		This doesn't seem to be happening anymore
+	Feature Requests:
+	Ideas:
+	Bugs:
+Archive:
+Search Definitions:
+	Top Priority @search(@priority = 5 and not @done)
+	High Priority @search(@priority > 3 and not @done)
+	Maybe @search(@maybe)
+	Next @search(@na and not @done and not project = "Archive")

data/ext/apex_ext/apex_src/apex_deflist_debug.log

@@ -0,0 +1,25 @@
+[deflist] conversion pipeline started; enable_definition_lists=1
+[deflist] apex_process_definition_lists (preprocessor) entered
+[deflist open_block] definition line recognized len=15
+[deflist open_block] prev=0x7f4c20000 type=32776 content.size=10 parser->current=0x7f4c20000
+[deflist open_block] content: **--foo**
+
+[deflist open_block] definition line recognized len=15
+[deflist postprocess] entered root=0x100bbe810 root.type=32769 first_child=0x7f4c20000
+  block=0x7f4c20000 type=32776
+  block=0x7f4c200c0 type=32783
+  block=0x7f4c20240 type=32776
+[deflist ensure_node_has_content_from_block] node=0x7f4c20000 content.len=10 ptr=0x100bbf130
+[deflist postprocess] def_list=0x7f4c200c0 term=0x7f4c20180 term_para=0x0 term_para.first_child=0x0 next_sib=0x0 next_sib.type=0 next_sib.first_child=0x0
+[deflist] conversion pipeline started; enable_definition_lists=1
+[deflist] apex_process_definition_lists (preprocessor) entered
+[deflist open_block] definition line recognized len=15
+[deflist open_block] prev=0x703020000 type=32776 content.size=10 parser->current=0x703020000
+[deflist open_block] content: **--foo**
+
+[deflist open_block] definition line recognized len=15
+[deflist postprocess] entered root=0x10534e980 root.type=32769 first_child=0x703020000
+  block=0x703020000 type=32776
+  block=0x7030200c0 type=32783
+  block=0x703020240 type=32776
+[deflist postprocess] def_list=0x7030200c0 term=0x703020180 term_para=0x703020600 term_para.first_child=0x7030203c0 next_sib=0x0 next_sib.type=0 next_sib.first_child=0x0