apex-ruby 1.0.18 → 1.0.20

data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html

@@ -5,8 +5,97 @@
 
       <meta charset="UTF-8">
       <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <meta name="generator" content="Apex 0.1.49">
+      <meta name="generator" content="Apex 1.1.12">
       <title>Document</title>
+      <style>
+        /* GitHub-style syntax highlighting for Pygments and Skylighting */
+        /* Don't apply background to wrapper when code highlighting is enabled - let default styles handle it */
+        .code-highlighted .highlight, .code-highlighted .sourceCode { background: inherit; border-radius: 6px; padding: 16px; overflow-x: auto; }
+        .highlight pre, .sourceCode pre { margin: 0; padding: 0; background: transparent; }
+        .highlight code, .sourceCode code { font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace; font-size: 12px; line-height: 1.45; }
+        /* Pygments classes */
+        .highlight .k { color: #d73a49; font-weight: 600; } /* Keyword */
+        .highlight .kt { color: #d73a49; } /* Keyword.Type */
+        .highlight .kd { color: #d73a49; font-weight: 600; } /* Keyword.Declaration */
+        .highlight .kn { color: #d73a49; } /* Keyword.Namespace */
+        .highlight .kp { color: #d73a49; } /* Keyword.Pseudo */
+        .highlight .kr { color: #d73a49; font-weight: 600; } /* Keyword.Reserved */
+        .highlight .n { color: #6f42c1; } /* Name */
+        .highlight .na { color: #6f42c1; } /* Name.Attribute */
+        .highlight .nc { color: #6f42c1; font-weight: 600; } /* Name.Class */
+        .highlight .no { color: #005cc5; } /* Name.Constant */
+        .highlight .nd { color: #6f42c1; font-weight: 600; } /* Name.Decorator */
+        .highlight .ni { color: #800080; } /* Name.Entity */
+        .highlight .ne { color: #990000; font-weight: 600; } /* Name.Exception */
+        .highlight .nf { color: #6f42c1; font-weight: 600; } /* Name.Function */
+        .highlight .nl { color: #6f42c1; } /* Name.Label */
+        .highlight .nn { color: #555; } /* Name.Namespace */
+        .highlight .nt { color: #22863a; } /* Name.Tag */
+        .highlight .nv { color: #e36209; } /* Name.Variable */
+        .highlight .s { color: #032f62; } /* String */
+        .highlight .sb { color: #032f62; } /* String.Backtick */
+        .highlight .sc { color: #032f62; } /* String.Char */
+        .highlight .sd { color: #032f62; } /* String.Doc */
+        .highlight .s2 { color: #032f62; } /* String.Double */
+        .highlight .se { color: #032f62; } /* String.Escape */
+        .highlight .sh { color: #032f62; } /* String.Heredoc */
+        .highlight .si { color: #032f62; } /* String.Interpol */
+        .highlight .sx { color: #032f62; } /* String.Other */
+        .highlight .sr { color: #032f62; } /* String.Regex */
+        .highlight .s1 { color: #032f62; } /* String.Single */
+        .highlight .ss { color: #032f62; } /* String.Symbol */
+        .highlight .c { color: #6a737d; font-style: italic; } /* Comment */
+        .highlight .c1 { color: #6a737d; font-style: italic; } /* Comment.Single */
+        .highlight .cm { color: #6a737d; font-style: italic; } /* Comment.Multiline */
+        .highlight .cp { color: #6a737d; font-weight: 600; } /* Comment.Preproc */
+        .highlight .cs { color: #6a737d; font-weight: 600; font-style: italic; } /* Comment.Special */
+        .highlight .m { color: #005cc5; } /* Literal.Number */
+        .highlight .mb { color: #005cc5; } /* Literal.Number.Bin */
+        .highlight .mf { color: #005cc5; } /* Literal.Number.Float */
+        .highlight .mh { color: #005cc5; } /* Literal.Number.Hex */
+        .highlight .mi { color: #005cc5; } /* Literal.Number.Integer */
+        .highlight .il { color: #005cc5; } /* Literal.Number.Integer.Long */
+        .highlight .mo { color: #005cc5; } /* Literal.Number.Oct */
+        .highlight .o { color: #d73a49; } /* Operator */
+        .highlight .ow { color: #d73a49; } /* Operator.Word */
+        .highlight .p { color: #24292e; } /* Punctuation */
+        .highlight .w { color: #e1e4e8; } /* Text.Whitespace */
+        /* Skylighting classes */
+        .sourceCode .kw { color: #d73a49; font-weight: 600; } /* Keyword */
+        .sourceCode .dt { color: #6f42c1; } /* DataType */
+        .sourceCode .dv { color: #005cc5; } /* DecVal */
+        .sourceCode .bn { color: #005cc5; } /* BaseN */
+        .sourceCode .fl { color: #005cc5; } /* Float */
+        .sourceCode .ch { color: #032f62; } /* Char */
+        .sourceCode .st { color: #032f62; } /* String */
+        .sourceCode .co { color: #6a737d; font-style: italic; } /* Comment */
+        .sourceCode .ot { color: #22863a; } /* Other */
+        .sourceCode .al { color: #e36209; font-weight: 600; } /* Alert */
+        .sourceCode .fu { color: #6f42c1; font-weight: 600; } /* Function */
+        .sourceCode .re { color: #032f62; } /* RegionMarker */
+        .sourceCode .er { color: #d73a49; font-weight: 600; } /* Error */
+        .sourceCode .cf { color: #d73a49; font-weight: 600; } /* ControlFlow */
+        .sourceCode .op { color: #d73a49; } /* Operator */
+        .sourceCode .pp { color: #6a737d; } /* Preprocessor */
+        .sourceCode .at { color: #005cc5; } /* Attribute */
+        .sourceCode .do { color: #6a737d; font-style: italic; } /* Documentation */
+        .sourceCode .an { color: #6a737d; font-weight: 600; } /* Annotation */
+        .sourceCode .cv { color: #6a737d; font-weight: 600; font-style: italic; } /* CommentVar */
+        .sourceCode .in { color: #6a737d; } /* Information */
+        .sourceCode .wa { color: #e36209; font-weight: 600; } /* Warning */
+        .sourceCode .im { color: #d73a49; } /* Import */
+        .sourceCode .bu { color: #005cc5; } /* BuiltIn */
+        .sourceCode .ex { color: #6f42c1; } /* Extension */
+        .sourceCode .va { color: #e36209; } /* Variable */
+        .sourceCode .ss { color: #032f62; } /* SpecialString */
+        .sourceCode .sc { color: #032f62; } /* SpecialChar */
+        .sourceCode .vs { color: #032f62; } /* VerbatimString */
+        .sourceCode .il { color: #005cc5; } /* Special */
+        /* Line numbers (Skylighting) */
+        .sourceCode.numberSource .sourceCode { counter-reset: line; }
+        .sourceCode.numberSource .sourceCode > span { position: relative; left: -4em; counter-increment: line; }
+        .sourceCode.numberSource .sourceCode > span > a:first-child::before { content: counter(line); position: relative; left: -1em; text-align: right; vertical-align: baseline; border: none; display: inline-block; min-width: 1em; padding-right: 0.5em; color: #aaa; }
+      </style>
       <style>
         body {
           font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
@@ -35,10 +124,52 @@
         ins { background: #d4fcbc; text-decoration: none; }
         del { background: #fbb6c2; text-decoration: line-through; }
         mark { background: #fff3cd; }
+        .smallcaps { font-variant: small-caps; }
+        .underline { text-decoration: underline; }
+        span.mark { background: #fff3cd; }
+        .hidden { display: none; }
+        .quarto-xref { font-variant: normal; }
         .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
+        .mkhashtag { color: #666; }
+        .mkstyledtag {
+          display: inline-block;
+          background: #e0e0e0;
+          padding: 3px 9px;
+          border-radius: 20px;
+          font-size: 0.9em;
+          line-height: 1.4;
+          color: #333;
+          margin: 0 2px;
+        }
       </style>
+        <meta name="paginate" content="symbols"/>
+      <meta name="highlight-language-only" content="true"/>
+      <meta name="code-line-numbers" content="false"/>
+      <meta name="code-highlight" content="pygments"/>
+      <meta name="sup-sub" content="true"/>
+      <meta name="relaxed-tables" content="true"/>
+      <meta name="includes" content="true"/>
+      <meta name="autolink" content="true"/>
+      <meta name="pretty" content="false"/>
+      <meta name="standalone" content="false"/>
+      <meta name="mode" content="unified"/>
+      <meta name="markdown-in-html" content="true"/>
+      <meta name="image-captions" content="true"/>
+      <meta name="wikilink-extension" content="html"/>
+      <meta name="wikilink-space" content="hyphen"/>
+      <meta name="wikilinks" content="true"/>
+      <meta name="widont" content="true"/>
+      <meta name="plugins" content="true"/>
+      <meta name="id-format" content="gfm"/>
+
   <style>
-/* Base styles */
+:root {
+  /* border-box width of the fixed sidebar; body offset includes a small gap */
+  --sidebar-width: 250px;
+  --sidebar-offset: 270px;
+}
+
+/* Base styles — override Apex standalone centering (max-width + margin: auto) */
 body {
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
@@ -48,6 +179,11 @@ body {
   line-height: 1.65;
   color: #1e293b;
   background-color: #fff;
+  max-width: none;
+  width: auto;
+  margin: 2rem 2rem 2rem var(--sidebar-offset);
+  padding: 0 1rem;
+  box-sizing: border-box;
 }
 
 /* Sidebar / Main TOC - wider on larger screens */
@@ -56,9 +192,10 @@ body {
   position: fixed;
   left: 0;
   top: 0;
-  width: auto;
-  min-width: 180px;
-  max-width: 250px;
+  box-sizing: border-box;
+  width: var(--sidebar-width);
+  min-width: var(--sidebar-width);
+  max-width: var(--sidebar-width);
   height: 100vh;
   overflow-y: auto;
   background: #1e293b;
@@ -67,7 +204,6 @@ body {
   padding: 24px 20px 130px;
   font-size: 14px;
   z-index: 100;
-  margin-right: 1rem;
   box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
   transition: transform 0.3s ease;
 }
@@ -116,11 +252,6 @@ body {
   font-weight: 500;
 }
 
-/* Body margin for sidebar */
-body {
-  margin-left: 270px;
-}
-
 /* Hamburger menu button */
 .hamburger-menu {
   display: none;
@@ -136,6 +267,7 @@ body {
   color: rgba(255, 255, 255, 0.9);
   font-size: 20px;
   line-height: 1;
+  box-sizing: border-box;
   width: 44px;
   height: 44px;
   align-items: center;
@@ -153,9 +285,7 @@ body {
 
 /* Move hamburger to the right of the sidebar when menu is open */
 .hamburger-menu.active {
-  left: calc(
-    250px + 12px
-  ); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
+  left: calc(var(--sidebar-width) + 12px);
 }
 
 .hamburger-menu.active {
@@ -251,7 +381,7 @@ body {
 .floating-toc {
   position: fixed;
   top: 0;
-  left: 270px;
+  left: var(--sidebar-offset);
   right: 0;
   z-index: 50;
   opacity: 0;
@@ -677,7 +807,7 @@ ol ul {
   }
 
   body {
-    margin-left: 0;
+    margin: 2rem 1rem;
   }
 
   .floating-toc {
@@ -687,7 +817,7 @@ ol ul {
 
 </style></head>
 
-  <body>
+  <body class="code-highlighted">
 <div class="floating-toc" id="floating-toc">
   <div class="floating-toc-container">
     <div class="floating-toc-header">
@@ -702,60 +832,67 @@ ol ul {
 <button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
 <div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
 
-<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
+<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Callouts.html">Callouts</a></li><li><a href="Tables.html">Tables</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Quarto-Mode.html">Quarto Mode</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Rendering-Markdown-In-Terminal.html">Rendering Markdown in the Terminal</a></li><li><a href="Generating-Man-Pages.html">Generating Man Pages</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Indices.html">Indices</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Using-Apex-with-Jekyll.html">Using Apex with Jekyll</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Writing-Tests.html">Writing Tests</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Filters.html">Filters</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
 
     <h1 id="examples">
       Examples
     </h1>
-<nav class="page-toc" id="page-toc-top"><ul><li><a href="#examples">Examples</a><ul><li><a href="#basic-conversion">Basic Conversion</a><ul><li><a href="#simple-markdown-to-html">Simple Markdown to HTML</a></li><li><a href="#from-stdin">From stdin</a></li></ul></li><li><a href="#blog-post-generation">Blog Post Generation</a></li><li><a href="#documentation-site">Documentation Site</a></li><li><a href="#github-compatible-readme">GitHub-Compatible README</a></li><li><a href="#review-document-with-critic-markup">Review Document with Critic Markup</a></li><li><a href="#wiki-style-documentation">Wiki-Style Documentation</a></li><li><a href="#math-document">Math Document</a></li><li><a href="#multimarkdown-document">MultiMarkdown Document</a></li><li><a href="#kramdown-document">Kramdown Document</a></li><li><a href="#c-program-example">C Program Example</a></li><li><a href="#objective-c-example">Objective-C Example</a></li><li><a href="#batch-processing">Batch Processing</a></li><li><a href="#pipeline-example">Pipeline Example</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#examples">Examples</a><ul><li><a href="#basic-conversion">Basic&nbsp;Conversion</a><ul><li><a href="#simple-markdown-to-html">Simple Markdown&nbsp;to&nbsp;HTML</a></li><li><a href="#from-stdin">From&nbsp;stdin</a></li></ul></li><li><a href="#blog-post-generation">Blog Post&nbsp;Generation</a></li><li><a href="#documentation-site">Documentation&nbsp;Site</a></li><li><a href="#github-compatible-readme">GitHub-Compatible&nbsp;README</a></li><li><a href="#review-document-with-critic-markup">Review Document with Critic&nbsp;Markup</a></li><li><a href="#wiki-style-documentation">Wiki-Style Documentation</a></li><li><a href="#math-document">Math&nbsp;Document</a></li><li><a href="#image-captions-and-figures">Image Captions and&nbsp;Figures</a></li><li><a href="#multimarkdown-document">MultiMarkdown&nbsp;Document</a></li><li><a href="#kramdown-document">Kramdown&nbsp;Document</a></li><li><a href="#c-program-example">C Program&nbsp;Example</a></li><li><a href="#objective-c-example">Objective-C&nbsp;Example</a></li><li><a href="#batch-processing">Batch&nbsp;Processing</a></li><li><a href="#pipeline-example">Pipeline&nbsp;Example</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
 
     <p>
       Practical examples of using Apex for common tasks.
     </p>
 
     <h2 id="basic-conversion">
-      Basic Conversion
+      Basic&nbsp;Conversion
     </h2>
 
     <h3 id="simple-markdown-to-html">
-      Simple Markdown to HTML
+      Simple Markdown&nbsp;to&nbsp;HTML
     </h3>
 
-<pre><code class="highlight language-bash">apex document.md <span class="o">&gt;</span> output.html
-</code></pre>
+    <div class="highlight">
+<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>&gt;<span class="w"> </span>output.html
+    </pre>
+  </div>
 
   <h3 id="from-stdin">
-    From stdin
+    From&nbsp;stdin
   </h3>
 
-<pre><code class="highlight language-bash"><span class="nb">echo</span> <span class="s2">"# Hello World"</span> | apex
-</code></pre>
+  <div class="highlight">
+<pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;# Hello World&quot;</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>apex
+  </pre>
+</div>
 
 <h2 id="blog-post-generation">
-  Blog Post Generation
+  Blog Post&nbsp;Generation
 </h2>
 
 <p>
   Generate a complete blog post with custom styling:
 </p>
 
-<pre><code class="highlight language-bash">apex post.md <span class="se">\</span>
-  <span class="nt">--standalone</span> <span class="se">\</span>
-  <span class="nt">--title</span> <span class="s2">"My Blog Post"</span> <span class="se">\</span>
-  <span class="nt">--style</span> blog.css <span class="se">\</span>
-  <span class="nt">--pretty</span> <span class="se">\</span>
-  <span class="nt">-o</span> post.html
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>post.md<span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--standalone<span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--title<span class="w"> </span><span class="s2">&quot;My Blog Post&quot;</span><span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--style<span class="w"> </span>blog.css<span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>--pretty<span class="w"> </span><span class="se">\</span>
+<span class="w">  </span>-o<span class="w"> </span>post.html
+</pre>
+</div>
 
 <h2 id="documentation-site">
-  Documentation Site
+  Documentation&nbsp;Site
 </h2>
 
 <p>
   Create documentation with table of contents:
 </p>
 
-<pre><code class="highlight language-markdown"><span class="c">&lt;!--TOC--&gt;</span>
+<div class="highlight">
+<pre><span></span>&lt;!--TOC--&gt;
 
 <span class="gh"># Introduction</span>
 ...
@@ -765,57 +902,70 @@ ol ul {
 
 <span class="gh"># API Reference</span>
 ...
-</code></pre>
+</pre>
+</div>
 
-<pre><code class="highlight language-bash">apex docs.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"Documentation"</span> <span class="nt">--pretty</span>
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>docs.md<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">&quot;Documentation&quot;</span><span class="w"> </span>--pretty
+</pre>
+</div>
 
 <h2 id="github-compatible-readme">
-  GitHub-Compatible README
+  GitHub-Compatible&nbsp;README
 </h2>
 
 <p>
   Convert README for GitHub preview:
 </p>
 
-<pre><code class="highlight language-bash">apex README.md <span class="nt">--mode</span> gfm <span class="nt">--pretty</span> <span class="o">&gt;</span> README.html
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>README.md<span class="w"> </span>--mode<span class="w"> </span>gfm<span class="w"> </span>--pretty<span class="w"> </span>&gt;<span class="w"> </span>README.html
+</pre>
+</div>
 
 <h2 id="review-document-with-critic-markup">
-  Review Document with Critic Markup
+  Review Document with Critic&nbsp;Markup
 </h2>
 
 <p>
-<strong>  Draft with changes:</strong>
+  <strong>Draft with changes:</strong>
 </p>
 
-<pre><code class="highlight language-markdown"><span class="gh"># Document</span>
+<div class="highlight">
+<pre><span></span><span class="gh"># Document</span>
 
-This is <span class="nt">&lt;ins</span> <span class="na">class=</span><span class="s">"critic"</span><span class="nt">&gt;</span>new text<span class="nt">&lt;/ins&gt;</span> and <span class="nt">&lt;del</span> <span class="na">class=</span><span class="s">"critic"</span><span class="nt">&gt;</span>old text<span class="nt">&lt;/del&gt;</span>.
+This is &lt;ins class=&quot;critic&quot;&gt;new text&lt;/ins&gt; and &lt;del class=&quot;critic&quot;&gt;old text&lt;/del&gt;.
 
-<span class="nt">&lt;del</span> <span class="na">class=</span><span class="s">"critic break"</span><span class="nt">&gt;</span>old<span class="nt">&lt;/del&gt;&lt;ins</span> <span class="na">class=</span><span class="s">"critic break"</span><span class="nt">&gt;</span>new<span class="nt">&lt;/ins&gt;</span> substitution.
-</code></pre>
+&lt;del class=&quot;critic break&quot;&gt;old&lt;/del&gt;&lt;ins class=&quot;critic break&quot;&gt;new&lt;/ins&gt; substitution.
+</pre>
+</div>
 
 <p>
-<strong>  Review mode (show all changes):</strong>
+  <strong>Review mode (show all changes):</strong>
 </p>
 
-<pre><code class="highlight language-bash">apex draft.md <span class="o">&gt;</span> review.html
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>draft.md<span class="w"> </span>&gt;<span class="w"> </span>review.html
+</pre>
+</div>
 
 <p>
-<strong>  Accept all changes (final version):</strong>
+  <strong>Accept all changes (final version):</strong>
 </p>
 
-<pre><code class="highlight language-bash">apex draft.md <span class="nt">--accept</span> <span class="o">&gt;</span> final.html
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>draft.md<span class="w"> </span>--accept<span class="w"> </span>&gt;<span class="w"> </span>final.html
+</pre>
+</div>
 
 <p>
-<strong>  Reject all changes (original):</strong>
+  <strong>Reject all changes (original):</strong>
 </p>
 
-<pre><code class="highlight language-bash">apex draft.md <span class="nt">--reject</span> <span class="o">&gt;</span> original.html
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>draft.md<span class="w"> </span>--reject<span class="w"> </span>&gt;<span class="w"> </span>original.html
+</pre>
+</div>
 
 <h2 id="wiki-style-documentation">
   Wiki-Style Documentation
@@ -825,159 +975,243 @@ This is <span class="nt">&lt;ins</span> <span class="na">class=</span><span clas
   Using wiki links and relaxed tables (requires <code>--wikilinks</code> flag):
 </p>
 
-<pre><code class="highlight language-markdown"><span class="gh"># Wiki Documentation</span>
+<div class="highlight">
+<pre><span></span><span class="gh"># Wiki Documentation</span>
 
 See [[Getting Started]] for details.
 
 <span class="gu">## Data Table</span>
 
 one | two | three
----|---|---|
 1 | 2 | 3
 4 | 5 | 6
-</code></pre>
+</pre>
+</div>
 
-<pre><code class="highlight language-bash">apex wiki.md <span class="nt">--mode</span> unified <span class="nt">--wikilinks</span> <span class="nt">--pretty</span>
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>wiki.md<span class="w"> </span>--mode<span class="w"> </span>unified<span class="w"> </span>--wikilinks<span class="w"> </span>--pretty
+</pre>
+</div>
 
 <h2 id="math-document">
-  Math Document
+  Math&nbsp;Document
 </h2>
 
 <p>
   Document with mathematical equations:
 </p>
 
-<pre><code class="highlight language-markdown"><span class="gh"># Math Examples</span>
+<div class="highlight">
+<pre><span></span><span class="gh"># Math Examples</span>
 
 Inline: $E = mc^2$
 
 Display:
 $$
-<span class="se">\i</span>nt_{-<span class="se">\i</span>nfty}^{<span class="se">\i</span>nfty} e^{-x^2} dx = <span class="se">\s</span>qrt{<span class="se">\p</span>i}
+\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
 $$
-</code></pre>
+</pre>
+</div>
+
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>math.md<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">&quot;Math Examples&quot;</span>
+</pre>
+</div>
+
+<h2 id="image-captions-and-figures">
+  Image Captions and&nbsp;Figures
+</h2>
+
+<p>
+  In unified and MultiMarkdown modes, Apex can automatically convert images with titles or alt text into semantic <code>&lt;figure&gt;</code> elements with <code>&lt;figcaption&gt;</code> captions. This is enabled by default via the <code>--image-captions</code> feature.
+</p>
+
+<p>
+  <strong>Input (<code>images.md</code>):</strong>
+</p>
 
-<pre><code class="highlight language-bash">apex math.md <span class="nt">--standalone</span> <span class="nt">--title</span> <span class="s2">"Math Examples"</span>
-</code></pre>
+<div class="highlight">
+<pre><span></span><span class="gh"># Image Examples</span>
+
+![<span class="nt">Alt only</span>](<span class="na">images/photo.png</span>)
+
+![<span class="nt">With title</span>](<span class="na">images/figure.png &quot;Figure caption&quot;</span>)
+
+![](images/plain.png)
+</pre>
+</div>
+
+<p>
+  <strong>Command (unified mode, default):</strong>
+</p>
+
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>images.md<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">&quot;Images&quot;</span><span class="w"> </span>--pretty
+</pre>
+</div>
+
+<p>
+  <strong>Output (simplified):</strong>
+</p>
+
+<div class="highlight">
+<pre><span></span><span class="p">&lt;</span><span class="nt">h1</span><span class="p">&gt;</span>Image Examples<span class="p">&lt;/</span><span class="nt">h1</span><span class="p">&gt;</span>
+<span class="p">&lt;</span><span class="nt">figure</span><span class="p">&gt;&lt;</span><span class="nt">img</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;images/photo.png&quot;</span> <span class="na">alt</span><span class="o">=</span><span class="s">&quot;Alt only&quot;</span><span class="p">&gt;&lt;</span><span class="nt">figcaption</span><span class="p">&gt;</span>Alt only<span class="p">&lt;/</span><span class="nt">figcaption</span><span class="p">&gt;&lt;/</span><span class="nt">figure</span><span class="p">&gt;</span>
+<span class="p">&lt;</span><span class="nt">figure</span><span class="p">&gt;&lt;</span><span class="nt">img</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;images/figure.png&quot;</span> <span class="na">alt</span><span class="o">=</span><span class="s">&quot;With title&quot;</span> <span class="na">title</span><span class="o">=</span><span class="s">&quot;Figure caption&quot;</span><span class="p">&gt;&lt;</span><span class="nt">figcaption</span><span class="p">&gt;</span>Figure caption<span class="p">&lt;/</span><span class="nt">figcaption</span><span class="p">&gt;&lt;/</span><span class="nt">figure</span><span class="p">&gt;</span>
+<span class="p">&lt;</span><span class="nt">img</span> <span class="na">src</span><span class="o">=</span><span class="s">&quot;images/plain.png&quot;</span> <span class="na">alt</span><span class="o">=</span><span class="s">&quot;&quot;</span><span class="p">&gt;</span>
+</pre>
+</div>
+
+<p>
+  To <strong>disable</strong> automatic image captions in unified or MultiMarkdown mode:
+</p>
+
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>images.md<span class="w"> </span>--mode<span class="w"> </span>unified<span class="w"> </span>--no-image-captions
+</pre>
+</div>
+
+<p>
+  To <strong>enable</strong> image captions in modes where they are off by default (e.g. GFM):
+</p>
+
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>images.md<span class="w"> </span>--mode<span class="w"> </span>gfm<span class="w"> </span>--image-captions
+</pre>
+</div>
 
 <h2 id="multimarkdown-document">
-  MultiMarkdown Document
+  MultiMarkdown&nbsp;Document
 </h2>
 
 <p>
   Using metadata and variables:
 </p>
 
-<pre><code class="highlight language-markdown"><span class="nn">---</span>
-<span class="na">title</span><span class="pi">:</span> <span class="s">Report</span>
-<span class="na">author</span><span class="pi">:</span> <span class="s">John Doe</span>
-<span class="na">date</span><span class="pi">:</span> <span class="s">2025-12-06</span>
-<span class="nn">---</span>
+<div class="highlight">
+<pre><span></span>---
+title: Report
+author: John Doe
+<span class="gu">date: 2025-12-06</span>
+<span class="gu">---</span>
 
 <span class="gh"># [%title]</span>
 
 By [%author] on [%date]
 
 Content here...
-</code></pre>
+</pre>
+</div>
 
 <p>
   See <a href="Metadata-Transforms.html">Metadata Transforms</a> for information on transforming metadata values with <code>[%key:transform]</code> syntax.
 </p>
 
-<pre><code class="highlight language-bash">apex report.md <span class="nt">--mode</span> mmd <span class="nt">--standalone</span>
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>report.md<span class="w"> </span>--mode<span class="w"> </span>mmd<span class="w"> </span>--standalone
+</pre>
+</div>
 
 <h2 id="kramdown-document">
-  Kramdown Document
+  Kramdown&nbsp;Document
 </h2>
 
 <p>
   With IAL attributes and relaxed tables:
 </p>
 
-<pre><code class="highlight language-markdown"><span class="gh"># Header {: #custom-id .class}</span>
+<div class="highlight">
+<pre><span></span><span class="gh"># Header {: #custom-id .class}</span>
 
 one | two
----|---|
 1 | 2
-</code></pre>
+</pre>
+</div>
 
-<pre><code class="highlight language-bash">apex doc.md <span class="nt">--mode</span> kramdown <span class="nt">--pretty</span>
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>doc.md<span class="w"> </span>--mode<span class="w"> </span>kramdown<span class="w"> </span>--pretty
+</pre>
+</div>
 
 <h2 id="c-program-example">
-  C Program Example
+  C Program&nbsp;Example
 </h2>
 
-<pre><code class="highlight language-c"><span class="cp">#include</span> <span class="cpf">&lt;apex/apex.h&gt;</span><span class="cp">
-#include</span> <span class="cpf">&lt;stdio.h&gt;</span><span class="cp">
-#include</span> <span class="cpf">&lt;string.h&gt;</span><span class="cp">
-</span>
-<span class="kt">int</span> <span class="nf">main</span><span class="p">()</span> <span class="p">{</span>
-    <span class="k">const</span> <span class="kt">char</span> <span class="o">*</span><span class="n">markdown</span> <span class="o">=</span>
-        <span class="s">"# Hello</span><span class="se">\n\n</span><span class="s">"</span>
-        <span class="s">"This is **bold** and a [[WikiLink]].</span><span class="se">\n\n</span><span class="s">"</span>
-        <span class="s">"Math: $E = mc^2$</span><span class="se">\n</span><span class="s">"</span><span class="p">;</span>
+<div class="highlight">
+<pre><span></span><span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;apex/apex.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;stdio.h&gt;</span>
+<span class="cp">#include</span><span class="w"> </span><span class="cpf">&lt;string.h&gt;</span>
 
-    <span class="n">apex_options</span> <span class="n">opts</span> <span class="o">=</span> <span class="n">apex_options_default</span><span class="p">();</span>
-    <span class="n">opts</span><span class="p">.</span><span class="n">pretty</span> <span class="o">=</span> <span class="nb">true</span><span class="p">;</span>
+<span class="kt">int</span><span class="w"> </span><span class="nf">main</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">const</span><span class="w"> </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">markdown</span><span class="w"> </span><span class="o">=</span>
+<span class="w">        </span><span class="s">&quot;# Hello</span><span class="se">\n\n</span><span class="s">&quot;</span>
+<span class="w">        </span><span class="s">&quot;This is **bold** and a [[WikiLink]].</span><span class="se">\n\n</span><span class="s">&quot;</span>
+<span class="w">        </span><span class="s">&quot;Math: $E = mc^2$</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">;</span>
 
-    <span class="kt">char</span> <span class="o">*</span><span class="n">html</span> <span class="o">=</span> <span class="n">apex_markdown_to_html</span><span class="p">(</span><span class="n">markdown</span><span class="p">,</span> <span class="n">strlen</span><span class="p">(</span><span class="n">markdown</span><span class="p">),</span> <span class="o">&amp;</span><span class="n">opts</span><span class="p">);</span>
+<span class="w">    </span><span class="n">apex_options</span><span class="w"> </span><span class="n">opts</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">apex_options_default</span><span class="p">();</span>
+<span class="w">    </span><span class="n">opts</span><span class="p">.</span><span class="n">pretty</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">true</span><span class="p">;</span>
 
-    <span class="k">if</span> <span class="p">(</span><span class="n">html</span><span class="p">)</span> <span class="p">{</span>
-        <span class="n">printf</span><span class="p">(</span><span class="s">"%s</span><span class="se">\n</span><span class="s">"</span><span class="p">,</span> <span class="n">html</span><span class="p">);</span>
-        <span class="n">apex_free_string</span><span class="p">(</span><span class="n">html</span><span class="p">);</span>
-        <span class="k">return</span> <span class="mi">0</span><span class="p">;</span>
-    <span class="p">}</span>
+<span class="w">    </span><span class="kt">char</span><span class="w"> </span><span class="o">*</span><span class="n">html</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">apex_markdown_to_html</span><span class="p">(</span><span class="n">markdown</span><span class="p">,</span><span class="w"> </span><span class="n">strlen</span><span class="p">(</span><span class="n">markdown</span><span class="p">),</span><span class="w"> </span><span class="o">&amp;</span><span class="n">opts</span><span class="p">);</span>
 
-    <span class="k">return</span> <span class="mi">1</span><span class="p">;</span>
+<span class="w">    </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="n">html</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
+<span class="w">        </span><span class="n">printf</span><span class="p">(</span><span class="s">&quot;%s</span><span class="se">\n</span><span class="s">&quot;</span><span class="p">,</span><span class="w"> </span><span class="n">html</span><span class="p">);</span>
+<span class="w">        </span><span class="n">apex_free_string</span><span class="p">(</span><span class="n">html</span><span class="p">);</span>
+<span class="w">        </span><span class="k">return</span><span class="w"> </span><span class="mi">0</span><span class="p">;</span>
+<span class="w">    </span><span class="p">}</span>
+
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="mi">1</span><span class="p">;</span>
 <span class="p">}</span>
-</code></pre>
+</pre>
+</div>
 
 <h2 id="objective-c-example">
-  Objective-C Example
+  Objective-C&nbsp;Example
 </h2>
 
-<pre><code class="highlight language-objective-c"><span class="cp">#import "NSString+Apex.h"
-</span>
-<span class="k">-</span> <span class="p">(</span><span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nf">convertMarkdownToHTML</span><span class="p">:(</span><span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">markdown</span> <span class="p">{</span>
-    <span class="k">return</span> <span class="p">[</span><span class="n">NSString</span> <span class="nf">convertWithApex</span><span class="p">:</span><span class="n">markdown</span><span class="p">];</span>
+<div class="highlight">
+<pre><span></span><span class="cp">#import &quot;NSString+Apex.h&quot;</span>
+
+<span class="p">-</span> <span class="p">(</span><span class="bp">NSString</span><span class="w"> </span><span class="o">*</span><span class="p">)</span><span class="nf">convertMarkdownToHTML:</span><span class="p">(</span><span class="bp">NSString</span><span class="w"> </span><span class="o">*</span><span class="p">)</span><span class="nv">markdown</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="p">[</span><span class="bp">NSString</span><span class="w"> </span><span class="n">convertWithApex</span><span class="o">:</span><span class="n">markdown</span><span class="p">];</span>
 <span class="p">}</span>
 
-<span class="k">-</span> <span class="p">(</span><span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nf">convertWithGFM</span><span class="p">:(</span><span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">markdown</span> <span class="p">{</span>
-    <span class="k">return</span> <span class="p">[</span><span class="n">NSString</span> <span class="nf">convertWithApex</span><span class="p">:</span><span class="n">markdown</span> <span class="nf">mode</span><span class="p">:</span><span class="s">@"gfm"</span><span class="p">];</span>
+<span class="p">-</span> <span class="p">(</span><span class="bp">NSString</span><span class="w"> </span><span class="o">*</span><span class="p">)</span><span class="nf">convertWithGFM:</span><span class="p">(</span><span class="bp">NSString</span><span class="w"> </span><span class="o">*</span><span class="p">)</span><span class="nv">markdown</span><span class="w"> </span><span class="p">{</span>
+<span class="w">    </span><span class="k">return</span><span class="w"> </span><span class="p">[</span><span class="bp">NSString</span><span class="w"> </span><span class="n">convertWithApex</span><span class="o">:</span><span class="n">markdown</span><span class="w"> </span><span class="n">mode</span><span class="o">:</span><span class="s">@&quot;gfm&quot;</span><span class="p">];</span>
 <span class="p">}</span>
-</code></pre>
+</pre>
+</div>
 
 <h2 id="batch-processing">
-  Batch Processing
+  Batch&nbsp;Processing
 </h2>
 
 <p>
   Process multiple files:
 </p>
 
-<pre><code class="highlight language-bash"><span class="k">for </span>file <span class="k">in</span> <span class="k">*</span>.md<span class="p">;</span> <span class="k">do
-    </span>apex <span class="s2">"</span><span class="nv">$file</span><span class="s2">"</span> <span class="nt">-o</span> <span class="s2">"</span><span class="k">${</span><span class="nv">file</span><span class="p">%.md</span><span class="k">}</span><span class="s2">.html"</span>
+<div class="highlight">
+<pre><span></span><span class="k">for</span><span class="w"> </span>file<span class="w"> </span><span class="k">in</span><span class="w"> </span>*.md<span class="p">;</span><span class="w"> </span><span class="k">do</span>
+<span class="w">    </span>apex<span class="w"> </span><span class="s2">&quot;</span><span class="nv">$file</span><span class="s2">&quot;</span><span class="w"> </span>-o<span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">file</span><span class="p">%.md</span><span class="si">}</span><span class="s2">.html&quot;</span>
 <span class="k">done</span>
-</code></pre>
+</pre>
+</div>
 
 <h2 id="pipeline-example">
-  Pipeline Example
+  Pipeline&nbsp;Example
 </h2>
 
 <p>
   Combine with other tools:
 </p>
 
-<pre><code class="highlight language-bash"><span class="c"># Preprocess with sed, then convert</span>
+<div class="highlight">
+<pre><span></span><span class="c1"># Preprocess with sed, then convert</span>
+sed<span class="w"> </span><span class="s1">&#39;s/OLD/NEW/g&#39;</span><span class="w"> </span>input.md<span class="w"> </span><span class="p">|</span><span class="w"> </span>apex<span class="w"> </span>&gt;<span class="w"> </span>output.html
 
-<span class="nb">sed</span> <span class="s1">'s/OLD/NEW/g'</span> input.md | apex <span class="o">&gt;</span> output.html
-<span class="c"># Convert and post-process</span>
-apex input.md | <span class="nb">sed</span> <span class="s1">'s/&lt;h1&gt;/&lt;h1 class="title"&gt;/g'</span> <span class="o">&gt;</span> output.html
-</code></pre>
+<span class="c1"># Convert and post-process</span>
+apex<span class="w"> </span>input.md<span class="w"> </span><span class="p">|</span><span class="w"> </span>sed<span class="w"> </span><span class="s1">&#39;s/&lt;h1&gt;/&lt;h1 class=&quot;title&quot;&gt;/g&#39;</span><span class="w"> </span>&gt;<span class="w"> </span>output.html
+</pre>
+</div>
 
 <h2 id="related">
   Related
@@ -986,15 +1220,15 @@ apex input.md | <span class="nb">sed</span> <span class="s1">'s/&lt;h1&gt;/&lt;h
 <ul>
 
   <li>
-<a href="Usage.html">    Usage</a> - More usage patterns
+    <a href="Usage.html">Usage</a> - More usage patterns
   </li>
 
   <li>
-<a href="Syntax.html">    Syntax</a> - Syntax examples
+    <a href="Syntax.html">Syntax</a> - Syntax examples
   </li>
 
   <li>
-<a href="Command-Line-Options.html">    Command Line Options</a> - All available options
+    <a href="Command-Line-Options.html">Command Line Options</a> - All available options
   </li>
 
 </ul>