RubyGems - apex-ruby - Versions diffs - 1.0.6 - Mend

apex-ruby 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (501) hide show

data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html ADDED Viewed

@@ -0,0 +1,1308 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+      <meta charset="UTF-8">
+      <meta name="viewport" content="width=device-width, initial-scale=1.0">
+      <meta name="generator" content="Apex 0.1.49">
+      <title>Document</title>
+      <style>
+        body {
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
+          line-height: 1.6;
+          max-width: 800px;
+          margin: 2rem auto;
+          padding: 0 1rem;
+          color: #333;
+        }
+        pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; }
+        code { background: #f0f0f0; padding: 0.2em 0.4em; border-radius: 3px; }
+        blockquote { border-left: 4px solid #ddd; margin: 0; padding-left: 1rem; color: #666; }
+        table { border-collapse: collapse; width: 100%%; }
+        th, td { border: 1px solid #ddd; padding: 0.5rem; }
+        th { background: #f5f5f5; }
+        tfoot td { background: #e8e8e8; }
+        figure.table-figure { width: fit-content; margin: 1em 0; }
+        figure.table-figure table { width: auto; }
+        figcaption { text-align: center; font-weight: bold; font-size: 0.8em; }
+        .page-break { page-break-after: always; }
+        .callout { padding: 1rem; margin: 1rem 0; border-left: 4px solid; }
+        .callout-note { border-color: #3b82f6; background: #eff6ff; }
+        .callout-warning { border-color: #f59e0b; background: #fffbeb; }
+        .callout-tip { border-color: #10b981; background: #f0fdf4; }
+        .callout-danger { border-color: #ef4444; background: #fef2f2; }
+        ins { background: #d4fcbc; text-decoration: none; }
+        del { background: #fbb6c2; text-decoration: line-through; }
+        mark { background: #fff3cd; }
+        .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
+      </style>
+  <style>
+/* Base styles */
+body {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+  font-size: 17px;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
+    "Helvetica Neue", Arial, sans-serif;
+  line-height: 1.65;
+  color: #1e293b;
+  background-color: #fff;
+}
+/* Sidebar / Main TOC - wider on larger screens */
+.main-toc,
+.sidebar {
+  position: fixed;
+  left: 0;
+  top: 0;
+  width: auto;
+  min-width: 180px;
+  max-width: 250px;
+  height: 100vh;
+  overflow-y: auto;
+  background: #1e293b;
+  color: rgba(255, 255, 255, 0.9);
+  border-right: 2px solid rgba(255, 255, 255, 0.1);
+  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;
+}
+.main-toc ul,
+.sidebar ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+  padding-bottom: 80px;
+}
+.main-toc ul::after,
+.sidebar ul::after {
+  content: "";
+  display: block;
+  height: 80px;
+}
+.main-toc li,
+.sidebar li {
+  margin: 0.25em 0;
+}
+.main-toc a,
+.sidebar a {
+  color: rgba(255, 255, 255, 0.85);
+  text-decoration: none;
+  display: block;
+  padding: 6px 12px;
+  border-radius: 4px;
+  transition: all 0.15s ease;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.main-toc a:hover,
+.sidebar a:hover {
+  background: #334155;
+  color: #fff;
+}
+.sidebar a.active {
+  color: #0ea5e9;
+  font-weight: 500;
+}
+/* Body margin for sidebar */
+body {
+  margin-left: 270px;
+}
+/* Hamburger menu button */
+.hamburger-menu {
+  display: none;
+  position: fixed;
+  top: 12px;
+  left: 12px;
+  z-index: 200;
+  background: #1e293b;
+  border: 2px solid rgba(255, 255, 255, 0.1);
+  border-radius: 6px;
+  padding: 10px;
+  cursor: pointer;
+  color: rgba(255, 255, 255, 0.9);
+  font-size: 20px;
+  line-height: 1;
+  width: 44px;
+  height: 44px;
+  align-items: center;
+  justify-content: center;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
+  transition: all 0.2s ease;
+  opacity: 0.2;
+}
+.hamburger-menu:hover {
+  background: #334155;
+  color: #fff;
+  opacity: 1;
+}
+/* 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) */
+}
+.hamburger-menu.active {
+  background: #0ea5e9;
+}
+.hamburger-menu::before {
+  content: "☰";
+}
+.hamburger-menu.active::before {
+  content: "✕";
+}
+/* Mobile menu overlay */
+.mobile-menu-overlay {
+  display: none;
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background: rgba(0, 0, 0, 0.5);
+  z-index: 150;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.3s ease, visibility 0.3s ease;
+}
+.mobile-menu-overlay.active {
+  opacity: 1;
+  visibility: visible;
+}
+/* Page TOC */
+.page-toc {
+  background: #f9f9f9;
+  border: 1px solid #ddd;
+  border-radius: 4px;
+  padding: 1rem;
+  margin: 1.5rem 0;
+}
+.page-toc ul {
+  list-style: none;
+  padding-left: 0;
+  margin: 0;
+}
+.page-toc > ul {
+  padding-left: 0;
+}
+.page-toc li {
+  margin: 0.25em 0;
+}
+.page-toc a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.25em 0.5em;
+  border-radius: 3px;
+}
+.page-toc a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.page-toc ul ul {
+  list-style: none;
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+  margin-left: 0;
+}
+.page-toc ul ul ul {
+  padding-left: 1.5em;
+}
+.page-toc ul ul a {
+  font-size: 0.9em;
+  color: #555;
+}
+.page-toc ul ul ul a {
+  font-size: 0.85em;
+  color: #666;
+}
+/* Floating TOC */
+.floating-toc {
+  position: fixed;
+  top: 0;
+  left: 270px;
+  right: 0;
+  z-index: 50;
+  opacity: 0;
+  visibility: hidden;
+  transition: opacity 0.2s ease, visibility 0.2s ease;
+  pointer-events: none;
+  display: flex;
+  justify-content: flex-end;
+  padding-right: 2rem;
+}
+.floating-toc.visible {
+  opacity: 1;
+  visibility: visible;
+  pointer-events: auto;
+}
+.floating-toc-container {
+  background: rgba(255, 255, 255, 0.95);
+  backdrop-filter: blur(10px);
+  border-bottom: 1px solid #ddd;
+  border-radius: 0 0 12px 12px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  width: fit-content;
+  max-width: 400px;
+  min-width: 200px;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-header {
+  padding: 8px 16px;
+  cursor: pointer;
+  user-select: none;
+  font-size: 14px;
+  font-weight: 500;
+  color: #1e293b;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.floating-toc-header:hover {
+  background: rgba(0, 0, 0, 0.02);
+}
+.floating-toc-content {
+  max-height: 0;
+  overflow: hidden;
+  transition: max-height 0.3s ease;
+}
+.floating-toc-container:hover .floating-toc-content {
+  max-height: 70vh;
+  overflow-y: auto;
+}
+.floating-toc-content ul {
+  list-style: none;
+  padding: 8px 16px 16px;
+  margin: 0;
+}
+.floating-toc-content li {
+  margin: 0.1em 0;
+}
+.floating-toc-content a {
+  color: #0066cc;
+  text-decoration: none;
+  display: block;
+  padding: 0.2em 0.5em;
+  border-radius: 4px;
+  font-size: 13px;
+  transition: background 0.15s ease;
+}
+.floating-toc-content a:hover {
+  background: #e0e0e0;
+  color: #004499;
+}
+.floating-toc-content ul ul {
+  padding-left: 1.2em;
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul ul {
+  margin-top: 0;
+  margin-bottom: 0;
+}
+.floating-toc-content ul ul a {
+  font-size: 12px;
+  color: #555;
+}
+.floating-toc-content ul ul ul a {
+  font-size: 11px;
+  color: #666;
+}
+/* Smooth scrolling */
+html {
+  scroll-behavior: smooth;
+}
+/* Code blocks */
+code {
+  background: #f0f0f0;
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+  font-family: "Monaco", "Menlo", "Ubuntu Mono", monospace;
+  font-size: 0.9em;
+  margin: 0 0.1em;
+}
+pre {
+  background: #f5f5f5;
+  padding: 1rem;
+  overflow-x: auto;
+  border-radius: 4px;
+  margin: 1em 0;
+}
+pre code {
+  background: none;
+  padding: 0;
+  margin: 0;
+}
+/* Rouge syntax highlighting - GitHub theme, scoped to .highlight containers */
+.highlight {
+  color: #24292e;
+}
+.highlight .c {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment */
+.highlight .err {
+  color: #a61717;
+  background-color: #e3d2d2;
+} /* Error */
+.highlight .k {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword */
+.highlight .l {
+  color: #032f62;
+} /* Literal */
+.highlight .n {
+  color: #24292e;
+} /* Name */
+.highlight .o {
+  color: #d73a49;
+} /* Operator */
+.highlight .p {
+  color: #24292e;
+} /* Punctuation */
+.highlight .cm {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Multiline */
+.highlight .cp {
+  color: #6a737d;
+  font-weight: bold;
+} /* Comment.Preproc */
+.highlight .c1 {
+  color: #6a737d;
+  font-style: italic;
+} /* Comment.Single */
+.highlight .cs {
+  color: #6a737d;
+  font-weight: bold;
+  font-style: italic;
+} /* Comment.Special */
+.highlight .gd {
+  color: #24292e;
+  background-color: #ffeef0;
+} /* Generic.Deleted */
+.highlight .ge {
+  color: #24292e;
+  font-style: italic;
+} /* Generic.Emph */
+.highlight .gr {
+  color: #aa0000;
+} /* Generic.Error */
+.highlight .gh {
+  color: #999999;
+  font-weight: bold;
+} /* Generic.Heading */
+.highlight .gi {
+  color: #24292e;
+  background-color: #f0fff4;
+} /* Generic.Inserted */
+.highlight .go {
+  color: #888888;
+} /* Generic.Output */
+.highlight .gp {
+  color: #555555;
+} /* Generic.Prompt */
+.highlight .gs {
+  font-weight: bold;
+} /* Generic.Strong */
+.highlight .gu {
+  color: #aaaaaa;
+} /* Generic.Subheading */
+.highlight .gt {
+  color: #aa0000;
+} /* Generic.Traceback */
+.highlight .kc {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Constant */
+.highlight .kd {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Declaration */
+.highlight .kn {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Namespace */
+.highlight .kp {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Pseudo */
+.highlight .kr {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Reserved */
+.highlight .kt {
+  color: #d73a49;
+  font-weight: bold;
+} /* Keyword.Type */
+.highlight .ld {
+  color: #032f62;
+} /* Literal.Date */
+.highlight .m {
+  color: #005cc5;
+} /* Literal.Number */
+.highlight .s {
+  color: #032f62;
+} /* Literal.String */
+.highlight .na {
+  color: #6f42c1;
+} /* Name.Attribute */
+.highlight .nb {
+  color: #005cc5;
+} /* Name.Builtin */
+.highlight .nc {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Class */
+.highlight .no {
+  color: #005cc5;
+} /* Name.Constant */
+.highlight .nd {
+  color: #6f42c1;
+  font-weight: bold;
+} /* Name.Decorator */
+.highlight .ni {
+  color: #800080;
+} /* Name.Entity */
+.highlight .ne {
+  color: #990000;
+  font-weight: bold;
+} /* Name.Exception */
+.highlight .nf {
+  color: #6f42c1;
+} /* Name.Function */
+.highlight .nl {
+  color: #990000;
+} /* Name.Label */
+.highlight .nn {
+  color: #555555;
+} /* Name.Namespace */
+.highlight .nx {
+  color: #6f42c1;
+} /* Name.Other */
+.highlight .py {
+  color: #990000;
+} /* Name.Property */
+.highlight .nt {
+  color: #22863a;
+} /* Name.Tag */
+.highlight .nv {
+  color: #e36209;
+} /* Name.Variable */
+.highlight .ow {
+  color: #d73a49;
+  font-weight: bold;
+} /* Operator.Word */
+.highlight .w {
+  color: #bbbbbb;
+} /* Text.Whitespace */
+.highlight .mf {
+  color: #005cc5;
+} /* Literal.Number.Float */
+.highlight .mh {
+  color: #005cc5;
+} /* Literal.Number.Hex */
+.highlight .mi {
+  color: #005cc5;
+} /* Literal.Number.Integer */
+.highlight .mo {
+  color: #005cc5;
+} /* Literal.Number.Oct */
+.highlight .sb {
+  color: #032f62;
+} /* Literal.String.Backtick */
+.highlight .sc {
+  color: #032f62;
+} /* Literal.String.Char */
+.highlight .sd {
+  color: #032f62;
+} /* Literal.String.Doc */
+.highlight .s2 {
+  color: #032f62;
+} /* Literal.String.Double */
+.highlight .se {
+  color: #032f62;
+} /* Literal.String.Escape */
+.highlight .sh {
+  color: #032f62;
+} /* Literal.String.Heredoc */
+.highlight .si {
+  color: #032f62;
+} /* Literal.String.Interpol */
+.highlight .sx {
+  color: #032f62;
+} /* Literal.String.Other */
+.highlight .sr {
+  color: #22863a;
+} /* Literal.String.Regex */
+.highlight .s1 {
+  color: #032f62;
+} /* Literal.String.Single */
+.highlight .ss {
+  color: #032f62;
+} /* Literal.String.Symbol */
+.highlight .bp {
+  color: #005cc5;
+} /* Name.Builtin.Pseudo */
+.highlight .vc {
+  color: #e36209;
+} /* Name.Variable.Class */
+.highlight .vg {
+  color: #e36209;
+} /* Name.Variable.Global */
+.highlight .vi {
+  color: #e36209;
+} /* Name.Variable.Instance */
+.highlight .il {
+  color: #005cc5;
+} /* Literal.Number.Integer.Long */
+/* Additional Rouge token classes that may be used */
+.highlight .token {
+  color: #5670a0;
+}
+.highlight .token.list {
+  color: #546e9f;
+}
+.highlight .token.punctuation {
+  color: #3e8dad;
+}
+.highlight .token.list.punctuation {
+  color: #e05b78;
+}
+.highlight .token.content {
+  padding: 0;
+}
+/* Nested lists in page content */
+ul ul,
+ol ol,
+ul ol,
+ol ul {
+  padding-left: 1.5em;
+  margin-top: 0.25em;
+}
+/* Page footer */
+.page-footer {
+  background: #f5f5f5;
+  border-top: 1px solid #ddd;
+  padding: 1.5rem;
+  margin-top: 3rem;
+  color: #666;
+  font-size: 0.9em;
+}
+.page-footer p {
+  margin: 0.5em 0;
+}
+.page-footer a {
+  color: #0066cc;
+  text-decoration: none;
+}
+.page-footer a:hover {
+  text-decoration: underline;
+}
+/* Mobile responsive */
+@media (max-width: 768px) {
+  .hamburger-menu {
+    display: flex;
+  }
+  .main-toc,
+  .sidebar {
+    transform: translateX(-100%);
+    z-index: 175;
+  }
+  .main-toc.mobile-open,
+  .sidebar.mobile-open {
+    transform: translateX(0);
+  }
+  body {
+    margin-left: 0;
+  }
+  .floating-toc {
+    left: 0;
+  }
+}
+</style></head>
+  <body>
+<div class="floating-toc" id="floating-toc">
+  <div class="floating-toc-container">
+    <div class="floating-toc-header">
+      <span>Table of Contents 🔻</span>
+    </div>
+    <div class="floating-toc-content" id="floating-toc-content">
+      <!-- Content will be populated by JavaScript -->
+    </div>
+  </div>
+</div>
+<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>
+    <h1 id="header-ids">
+      Header IDs
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#header-ids">Header IDs</a><ul><li><a href="#automatic-generation">Automatic Generation</a></li><li><a href="#id-formats">ID Formats</a><ul><li><a href="#gfm-format-default">GFM Format (Default)</a></li><li><a href="#multimarkdown-format">MultiMarkdown Format</a></li><li><a href="#kramdown-format">Kramdown Format</a></li></ul></li><li><a href="#setting-id-format">Setting ID Format</a><ul><li><a href="#by-mode">By Mode</a></li><li><a href="#override-in-unified-mode">Override in Unified Mode</a></li></ul></li><li><a href="#manual-header-ids">Manual Header IDs</a><ul><li><a href="#multimarkdown-syntax">MultiMarkdown Syntax</a></li><li><a href="#kramdown-syntax">Kramdown Syntax</a></li><li><a href="#inline-attribute-list-ial">Inline Attribute List (IAL)</a></li></ul></li><li><a href="#anchor-tags-vs-ids">Anchor Tags vs. IDs</a></li><li><a href="#examples">Examples</a><ul><li><a href="#gfm-format">GFM Format</a></li><li><a href="#multimarkdown-format">MultiMarkdown Format</a></li><li><a href="#kramdown-format">Kramdown Format</a></li></ul></li><li><a href="#linking-to-headers">Linking to Headers</a></li><li><a href="#table-of-contents">Table of Contents</a></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
+    <p>
+      Apex automatically generates unique IDs for all headers, making it easy to link to specific sections. Different processor modes use different ID generation rules.
+    </p>
+    <h2 id="automatic-generation">
+      Automatic Generation
+    </h2>
+    <p>
+      By default, Apex generates header IDs automatically. You can disable this with <code>--no-ids</code>:
+    </p>
+<pre><code class="highlight language-bash">apex document.md <span class="nt">--no-ids</span>
+</code></pre>
+  <h2 id="id-formats">
+    ID Formats
+  </h2>
+  <p>
+    Apex supports three ID formats, each matching the behavior of different Markdown processors:
+  </p>
+  <h3 id="gfm-format-default">
+    GFM Format (Default)
+  </h3>
+  <p>
+    Used by default in unified and GFM modes. Matches GitHub’s header ID generation:
+  </p>
+  <p>
+<strong>    Rules:</strong>
+  </p>
+  <ul>
+    <li>
+      Spaces become single dashes
+    </li>
+    <li>
+      Em dashes (—) and en dashes (–) are removed
+    </li>
+    <li>
+      Punctuation is removed
+    </li>
+    <li>
+      Other whitespace is removed
+    </li>
+    <li>
+      Diacritics are normalized to ASCII equivalents (é → e, ñ → n, etc.)
+    </li>
+    <li>
+<strong>      Emojis are converted to their textual names</strong> (e.g., 😄 → “smile”, 🚀 → “rocket”)
+    </li>
+    <li>
+      Leading and trailing dashes are trimmed
+    </li>
+    <li>
+      Result is lowercased
+    </li>
+  </ul>
+  <p>
+<strong>    Examples:</strong>
+  </p>
+<pre><code class="highlight language-markdown"><span class="gh"># Emoji Support</span>
+→ id="emoji-support"
+<span class="gh"># 😄 Emoji Support</span>
+→ id="smile-emoji-support"
+<span class="gh"># 🚀</span>
+→ id="rocket"
+<span class="gh"># 👍 👎</span>
+→ id="thumbsup-thumbsdown"
+<span class="gh"># Hello—World</span>
+→ id="helloworld"
+<span class="gh"># C++ Programming</span>
+→ id="c-programming"
+<span class="gh"># Déjà Vu</span>
+→ id="deja-vu"
+</code></pre>
+<p>
+<strong>  Note:</strong> Emoji-to-name conversion matches Pandoc’s GFM behavior, ensuring emojis in headers are represented as readable text in IDs. This only applies to GFM format; MMD and Kramdown formats preserve emojis as-is or remove them according to their respective rules.
+</p>
+<h3 id="multimarkdown-format">
+  MultiMarkdown Format
+</h3>
+<p>
+  Used in MultiMarkdown mode. Preserves dashes and diacritics:
+</p>
+<p>
+<strong>  Rules:</strong>
+</p>
+<ul>
+  <li>
+    Spaces are removed (not converted to dashes)
+  </li>
+  <li>
+    All dash types (regular, em, en) are preserved
+  </li>
+  <li>
+    Diacritics are preserved (UTF-8)
+  </li>
+  <li>
+    Punctuation is removed
+  </li>
+  <li>
+    Leading and trailing dashes are preserved
+  </li>
+  <li>
+    Result is lowercased
+  </li>
+</ul>
+<p>
+<strong>  Examples:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Header—One</span>
+→ id="header—one"
+<span class="gh"># Hello World</span>
+→ id="helloworld"
+<span class="gh"># Déjà Vu</span>
+→ id="déjà-vu"
+</code></pre>
+<h3 id="kramdown-format">
+  Kramdown Format
+</h3>
+<p>
+  Used in Kramdown mode. More aggressive punctuation handling:
+</p>
+<p>
+<strong>  Rules:</strong>
+</p>
+<ul>
+  <li>
+    Spaces become single dashes (one dash per space)
+  </li>
+  <li>
+    Em dashes (—) and en dashes (–) are removed
+  </li>
+  <li>
+    Diacritics are removed (not normalized)
+  </li>
+  <li>
+    Punctuation becomes dashes (except trailing punctuation is removed)
+  </li>
+  <li>
+    If punctuation is followed by a space, the space is skipped
+  </li>
+  <li>
+    Leading dashes are trimmed
+  </li>
+  <li>
+    Trailing dashes are preserved
+  </li>
+  <li>
+    Result is lowercased
+  </li>
+</ul>
+<p>
+<strong>  Examples:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Hello, World!</span>
+→ id="hello-world"
+<span class="gh"># C++ Programming</span>
+→ id="c-programming"
+<span class="gh"># Test (Example)</span>
+→ id="test-example"
+</code></pre>
+<h2 id="setting-id-format">
+  Setting ID Format
+</h2>
+<h3 id="by-mode">
+  By Mode
+</h3>
+<p>
+  Each mode automatically sets the appropriate ID format:
+</p>
+<ul>
+  <li>
+<code>--mode gfm</code> → GFM format
+  </li>
+  <li>
+<code>--mode mmd</code> → MultiMarkdown format
+  </li>
+  <li>
+<code>--mode kramdown</code> → Kramdown format
+  </li>
+  <li>
+<code>--mode unified</code> → GFM format (default)
+  </li>
+</ul>
+<h3 id="override-in-unified-mode">
+  Override in Unified Mode
+</h3>
+<p>
+  In unified mode, you can override the default GFM format:
+</p>
+<pre><code class="highlight language-bash"><span class="c"># Use MMD format in unified mode</span>
+apex document.md <span class="nt">--mode</span> unified <span class="nt">--id-format</span> mmd
+<span class="c"># Use Kramdown format in unified mode</span>
+apex document.md <span class="nt">--mode</span> unified <span class="nt">--id-format</span> kramdown
+</code></pre>
+<h2 id="manual-header-ids">
+  Manual Header IDs
+</h2>
+<p>
+  You can manually specify header IDs using several syntaxes:
+</p>
+<h3 id="multimarkdown-syntax">
+  MultiMarkdown Syntax
+</h3>
+<pre><code class="highlight language-markdown"><span class="gu">### Heading 1 [heading1]</span>
+</code></pre>
+<h3 id="kramdown-syntax">
+  Kramdown Syntax
+</h3>
+<pre><code class="highlight language-markdown"><span class="gu">### Heading 1 {#heading1}</span>
+</code></pre>
+<h3 id="inline-attribute-list-ial">
+  Inline Attribute List (IAL)
+</h3>
+<pre><code class="highlight language-markdown"><span class="gu">### Heading 1 {: #heading1}</span>
+</code></pre>
+<p>
+  Manual IDs take precedence over auto-generated IDs.
+</p>
+<h2 id="anchor-tags-vs-ids">
+  Anchor Tags vs. IDs
+</h2>
+<p>
+  By default, Apex adds <code>id</code> attributes directly to header elements:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"my-header"</span><span class="nt">&gt;</span>My Header<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<p>
+  You can generate <code>&lt;a&gt;</code> anchor tags instead:
+</p>
+<pre><code class="highlight language-bash">apex document.md <span class="nt">--header-anchors</span>
+</code></pre>
+<p>
+  This produces:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1&gt;&lt;a</span> <span class="na">id=</span><span class="s">"my-header"</span> <span class="na">href=</span><span class="s">"#my-header"</span><span class="nt">&gt;</span>My Header<span class="nt">&lt;/a&gt;&lt;/h1&gt;</span>
+</code></pre>
+<p>
+  This format is compatible with some Markdown processors that use anchor tags.
+</p>
+<h2 id="examples">
+  Examples
+</h2>
+<h3 id="gfm-format">
+  GFM Format
+</h3>
+<pre><code class="highlight language-markdown"><span class="gh"># Getting Started with Apex</span>
+<span class="gh"># Advanced Features</span>
+<span class="gh"># C++ Integration</span>
+</code></pre>
+<p>
+  Becomes:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"getting-started-with-apex"</span><span class="nt">&gt;</span>Getting Started with Apex<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"advanced-features"</span><span class="nt">&gt;</span>Advanced Features<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"c-integration"</span><span class="nt">&gt;</span>C Integration<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<h3 id="multimarkdown-format">
+  MultiMarkdown Format
+</h3>
+<pre><code class="highlight language-markdown"><span class="gh"># Getting Started with Apex</span>
+<span class="gh"># Advanced Features</span>
+<span class="gh"># C++ Integration</span>
+</code></pre>
+<p>
+  With <code>--id-format mmd</code>:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"gettingstartedwithapex"</span><span class="nt">&gt;</span>Getting Started with Apex<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"advancedfeatures"</span><span class="nt">&gt;</span>Advanced Features<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"cintegration"</span><span class="nt">&gt;</span>C Integration<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<h3 id="kramdown-format">
+  Kramdown Format
+</h3>
+<pre><code class="highlight language-markdown"><span class="gh"># Getting Started with Apex</span>
+<span class="gh"># Advanced Features</span>
+<span class="gh"># C++ Integration</span>
+</code></pre>
+<p>
+  With <code>--id-format kramdown</code>:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"getting-started-with-apex"</span><span class="nt">&gt;</span>Getting Started with Apex<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"advanced-features"</span><span class="nt">&gt;</span>Advanced Features<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"c-integration"</span><span class="nt">&gt;</span>C Integration<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<h2 id="linking-to-headers">
+  Linking to Headers
+</h2>
+<p>
+  Once headers have IDs, you can link to them:
+</p>
+<pre><code class="highlight language-markdown"><span class="p">[</span><span class="nv">Link to section</span><span class="p">](</span><span class="sx">#getting-started-with-apex</span><span class="p">)</span>
+</code></pre>
+<p>
+  Or with wiki links (requires <code>--wikilinks</code> flag):
+</p>
+<pre><code class="highlight language-markdown">[[Document#getting-started-with-apex]]
+</code></pre>
+<h2 id="table-of-contents">
+  Table of Contents
+</h2>
+<p>
+  Apex’s TOC generation automatically uses the same ID format as your headers. See <a href="Syntax.html">Syntax</a> for TOC details.
+</p>
+<h2 id="related">
+  Related
+</h2>
+<ul>
+  <li>
+<a href="Modes.html">    Modes</a> - How modes affect ID generation
+  </li>
+  <li>
+<a href="Command-Line-Options.html">    Command Line Options</a> - ID-related flags
+  </li>
+  <li>
+<a href="Syntax.html">    Syntax</a> - Manual ID syntax
+  </li>
+</ul>
+<script>
+// Hamburger menu functionality
+(function() {
+  function initHamburgerMenu() {
+    var hamburger = document.getElementById('hamburger-menu');
+    var sidebar = document.querySelector('.main-toc, .sidebar');
+    var overlay = document.getElementById('mobile-menu-overlay');
+    if (!hamburger || !sidebar) return;
+    function toggleMenu() {
+      var isOpen = sidebar.classList.contains('mobile-open');
+      if (isOpen) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      } else {
+        sidebar.classList.add('mobile-open');
+        hamburger.classList.add('active');
+        if (overlay) overlay.classList.add('active');
+      }
+    }
+    hamburger.addEventListener('click', function(e) {
+      e.stopPropagation();
+      toggleMenu();
+    });
+    if (overlay) {
+      overlay.addEventListener('click', function() {
+        toggleMenu();
+      });
+    }
+    // Close menu when clicking on a sidebar link (mobile only)
+    if (window.innerWidth <= 768) {
+      var sidebarLinks = sidebar.querySelectorAll('a');
+      sidebarLinks.forEach(function(link) {
+        link.addEventListener('click', function() {
+          setTimeout(function() {
+            sidebar.classList.remove('mobile-open');
+            hamburger.classList.remove('active');
+            if (overlay) overlay.classList.remove('active');
+          }, 100);
+        });
+      });
+    }
+    // Close menu on window resize if going to desktop
+    window.addEventListener('resize', function() {
+      if (window.innerWidth > 768) {
+        sidebar.classList.remove('mobile-open');
+        hamburger.classList.remove('active');
+        if (overlay) overlay.classList.remove('active');
+      }
+    });
+  }
+  // Initialize when DOM is ready
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', initHamburgerMenu);
+  } else {
+    initHamburgerMenu();
+  }
+})();
+</script>
+<script>
+  (function() {
+    // Clone the page TOC for floating TOC
+    function initFloatingTOC() {
+      var pageTOC = document.getElementById('page-toc-top');
+      var floatingTOCContent = document.getElementById('floating-toc-content');
+      var floatingTOC = document.getElementById('floating-toc');
+      if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
+      // Clone the TOC structure
+      var tocClone = pageTOC.cloneNode(true);
+      tocClone.id = 'floating-toc-clone';
+      floatingTOCContent.appendChild(tocClone);
+      // Update all links to use smooth scrolling
+      var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
+      allTOCLinks.forEach(function(link) {
+        link.addEventListener('click', function(e) {
+          var href = this.getAttribute('href');
+          if (href && href.startsWith('#')) {
+            e.preventDefault();
+            var targetId = href.substring(1);
+            var targetElement = document.getElementById(targetId);
+            if (targetElement) {
+              var offset = 20; // Offset from top
+              // Function to calculate absolute position from document top
+              function getAbsoluteTop(element) {
+                var top = 0;
+                while (element) {
+                  top += element.offsetTop;
+                  element = element.offsetParent;
+                }
+                return top;
+              }
+              var absoluteTop = getAbsoluteTop(targetElement);
+              var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
+              var offsetPosition = absoluteTop - offset;
+              // Only scroll if we're not already at the target position
+              if (Math.abs(scrollTop - offsetPosition) > 10) {
+                window.scrollTo({
+                  top: Math.max(0, offsetPosition),
+                  behavior: 'smooth'
+                });
+              }
+              // Update URL hash without triggering scroll
+              if (history.pushState) {
+                history.pushState(null, null, href);
+              }
+            }
+          }
+        });
+      });
+      // Handle scroll to show/hide floating TOC
+      var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
+      var tocBottom = tocTop + pageTOC.offsetHeight;
+      function updateFloatingTOC() {
+        var scrollY = window.pageYOffset || document.documentElement.scrollTop;
+        if (scrollY > tocBottom) {
+          floatingTOC.classList.add('visible');
+        } else {
+          floatingTOC.classList.remove('visible');
+        }
+      }
+      // Throttle scroll events
+      var ticking = false;
+      window.addEventListener('scroll', function() {
+        if (!ticking) {
+          window.requestAnimationFrame(function() {
+            updateFloatingTOC();
+            ticking = false;
+          });
+          ticking = true;
+        }
+      });
+      // Initial check
+      updateFloatingTOC();
+    }
+    // Initialize when DOM is ready
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', initFloatingTOC);
+    } else {
+      initFloatingTOC();
+    }
+  })();
+</script>
+<footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
+</html>