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/Inline-Attribute-Lists.html ADDED Viewed

@@ -0,0 +1,1622 @@
+<!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="inline-attribute-lists-ials-and-attribute-list-definitions-alds">
+      Inline Attribute Lists (IALs) and Attribute List Definitions (ALDs)
+    </h1>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#inline-attribute-lists-ials-and-attribute-list-definitions-alds">Inline Attribute Lists (IALs) and Attribute List Definitions (ALDs)</a><ul><li><a href="#overview">Overview</a></li><li><a href="#block-level-ials">Block-Level IALs</a><ul><li><a href="#paragraphs">Paragraphs</a></li><li><a href="#headings">Headings</a></li><li><a href="#lists">Lists</a></li><li><a href="#blockquotes">Blockquotes</a></li><li><a href="#tables">Tables</a></li></ul></li><li><a href="#inline-ials">Inline IALs</a><ul><li><a href="#links">Links</a></li><li><a href="#images">Images</a></li><li><a href="#emphasis-and-strong">Emphasis and Strong</a></li><li><a href="#code-spans">Code Spans</a></li></ul></li><li><a href="#attribute-syntax">Attribute Syntax</a><ul><li><a href="#1-ids">1. IDs</a></li><li><a href="#2-classes">2. Classes</a></li><li><a href="#3-key-value-pairs">3. Key-Value Pairs</a></li><li><a href="#combining-attributes">Combining Attributes</a></li></ul></li><li><a href="#attribute-list-definitions-alds">Attribute List Definitions (ALDs)</a><ul><li><a href="#defining-alds">Defining ALDs</a></li><li><a href="#ald-syntax">ALD Syntax</a></li><li><a href="#referencing-alds">Referencing ALDs</a></li><li><a href="#mixed-usage">Mixed Usage</a></li></ul></li><li><a href="#important-notes">Important Notes</a><ul><li><a href="#block-level-ial-positioning">Block-Level IAL Positioning</a></li><li><a href="#inline-ial-positioning">Inline IAL Positioning</a></li><li><a href="#multiple-elements-with-same-attributes">Multiple Elements with Same Attributes</a></li><li><a href="#nested-elements">Nested Elements</a></li></ul></li><li><a href="#examples">Examples</a><ul><li><a href="#complete-example">Complete Example</a></li><li><a href="#using-alds-for-consistent-styling">Using ALDs for Consistent Styling</a></li></ul></li><li><a href="#related">Related</a></li></ul></li></ul></nav>
+    <p>
+      Inline Attribute Lists (IALs) allow you to add HTML attributes (IDs, classes, and custom key-value pairs) to Markdown elements. Attribute List Definitions (ALDs) let you define reusable attribute sets that can be referenced multiple times.
+    </p>
+    <p>
+      This feature is available in <strong>Kramdown</strong> and <strong>unified</strong> modes.
+    </p>
+    <h2 id="overview">
+      Overview
+    </h2>
+    <p>
+      IALs use the syntax <code>{: attributes}</code> (Kramdown-style) or <code>{#id .class}</code> (Pandoc-style) and can be applied to:
+    </p>
+    <ul>
+      <li>
+<strong>        Block-level elements</strong>: Headings, paragraphs, lists, blockquotes, code blocks, tables
+      </li>
+      <li>
+<strong>        Span-level elements</strong>: Links, images, emphasis (italic), strong (bold), code spans
+      </li>
+    </ul>
+    <p>
+      Apex supports both formats:
+    </p>
+    <ul>
+      <li>
+<strong>        Kramdown-style</strong>: <code>{: #id .class key=&quot;value&quot;}</code> - requires a colon after the opening brace
+      </li>
+      <li>
+<strong>        Pandoc-style</strong>: <code>{#id .class key=&quot;value&quot;}</code> - no colon required
+      </li>
+    </ul>
+    <p>
+      Both formats work identically. For example, <code>{#my-id .my-class}</code> is equivalent to <code>{:#my-id .my-class}</code>.
+    </p>
+    <p>
+      ALDs define reusable attribute sets with the syntax <code>{🚗 attributes}</code> and can be referenced in IALs using <code>{:ref-name}</code>.
+    </p>
+    <h2 id="block-level-ials">
+      Block-Level IALs
+    </h2>
+    <p>
+      For block-level elements, IALs appear on a separate line immediately after the element (no blank line).
+    </p>
+    <h3 id="paragraphs">
+      Paragraphs
+    </h3>
+<pre><code class="highlight language-markdown">This is a paragraph with an ID and classes.
+{: #para-id .important .note}
+This is a paragraph using Pandoc-style IAL.
+{#para-id-2 .important .note}
+Another paragraph with custom attributes.
+{: title="Important Note" lang="en"}
+</code></pre>
+  <p>
+    Output:
+  </p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p</span> <span class="na">id=</span><span class="s">"para-id"</span> <span class="na">class=</span><span class="s">"important note"</span><span class="nt">&gt;</span>This is a paragraph with an ID and classes.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p</span> <span class="na">id=</span><span class="s">"para-id-2"</span> <span class="na">class=</span><span class="s">"important note"</span><span class="nt">&gt;</span>This is a paragraph using Pandoc-style IAL.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p</span> <span class="na">title=</span><span class="s">"Important Note"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Another paragraph with custom attributes.<span class="nt">&lt;/p&gt;</span>
+</code></pre>
+<h3 id="headings">
+  Headings
+</h3>
+<p>
+  Headings can have IALs on the same line or the next line:
+</p>
+<p>
+<strong>  Same line:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Heading {: #custom-id}</span>
+<span class="gu">## Another Heading {: .highlight .large}</span>
+<span class="gu">## Pandoc-style Heading {#pandoc-id .highlight}</span>
+</code></pre>
+<p>
+<strong>  Next line:</strong>
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Heading</span>
+{: #custom-id .highlight}
+<span class="gh"># Pandoc-style Heading</span>
+{#pandoc-id-2 .highlight}
+<span class="gu">## Another Heading</span>
+{: .section-title lang="en"}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"custom-id"</span><span class="nt">&gt;</span>Heading<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h2</span> <span class="na">class=</span><span class="s">"highlight large"</span><span class="nt">&gt;</span>Another Heading<span class="nt">&lt;/h2&gt;</span>
+<span class="nt">&lt;h2</span> <span class="na">id=</span><span class="s">"pandoc-id"</span> <span class="na">class=</span><span class="s">"highlight"</span><span class="nt">&gt;</span>Pandoc-style Heading<span class="nt">&lt;/h2&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"custom-id"</span> <span class="na">class=</span><span class="s">"highlight"</span><span class="nt">&gt;</span>Heading<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"pandoc-id-2"</span> <span class="na">class=</span><span class="s">"highlight"</span><span class="nt">&gt;</span>Pandoc-style Heading<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h2</span> <span class="na">class=</span><span class="s">"section-title"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Another Heading<span class="nt">&lt;/h2&gt;</span>
+</code></pre>
+<h3 id="lists">
+  Lists
+</h3>
+<pre><code class="highlight language-markdown"><span class="p">-</span> Item 1
+<span class="p">-</span> Item 2
+<span class="p">-</span> Item 3
+{: .unordered-list .compact}
+<span class="p">
+1.</span> First
+<span class="p">2.</span> Second
+<span class="p">3.</span> Third
+{: #ordered-list .numbered}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;ul</span> <span class="na">class=</span><span class="s">"unordered-list compact"</span><span class="nt">&gt;</span>
+  <span class="nt">&lt;li&gt;</span>Item 1<span class="nt">&lt;/li&gt;</span>
+  <span class="nt">&lt;li&gt;</span>Item 2<span class="nt">&lt;/li&gt;</span>
+  <span class="nt">&lt;li&gt;</span>Item 3<span class="nt">&lt;/li&gt;</span>
+<span class="nt">&lt;/ul&gt;</span>
+<span class="nt">&lt;ol</span> <span class="na">id=</span><span class="s">"ordered-list"</span> <span class="na">class=</span><span class="s">"numbered"</span><span class="nt">&gt;</span>
+  <span class="nt">&lt;li&gt;</span>First<span class="nt">&lt;/li&gt;</span>
+  <span class="nt">&lt;li&gt;</span>Second<span class="nt">&lt;/li&gt;</span>
+  <span class="nt">&lt;li&gt;</span>Third<span class="nt">&lt;/li&gt;</span>
+<span class="nt">&lt;/ol&gt;</span>
+</code></pre>
+<h3 id="blockquotes">
+  Blockquotes
+</h3>
+<pre><code class="highlight language-markdown"><span class="gt">&gt; This is a quote.</span>
+{: .quote .inspirational}
+<span class="gt">
+&gt; Another quote with attribution.</span>
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;blockquote</span> <span class="na">class=</span><span class="s">"quote inspirational"</span><span class="nt">&gt;</span>
+  <span class="nt">&lt;p&gt;</span>This is a quote.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;/blockquote&gt;</span>
+<span class="nt">&lt;blockquote</span> <span class="na">cite=</span><span class="s">"https://example.com"</span><span class="nt">&gt;</span>
+  <span class="nt">&lt;p&gt;</span>Another quote with attribution.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;/blockquote&gt;</span>
+</code></pre>
+<h3 id="tables">
+  Tables
+</h3>
+<p>
+  Tables can have IALs applied on a separate line after the table:
+</p>
+<pre><code class="highlight language-markdown">| Key | Value |
+| --- | :---: |
+| one |   1   |
+| --- | --- |
+| two |   2   |
+{: #data-table .striped .bordered}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;table</span> <span class="na">id=</span><span class="s">"data-table"</span> <span class="na">class=</span><span class="s">"striped bordered"</span><span class="nt">&gt;</span>
+  <span class="c">&lt;!-- table content --&gt;</span>
+<span class="nt">&lt;/table&gt;</span>
+</code></pre>
+<p>
+<strong>  Pandoc table_attributes extension:</strong>
+</p>
+<p>
+  Apex also supports Pandoc’s <code>table_attributes</code> extension, which allows IAL attributes to be specified in table captions. When using Pandoc-style captions with the <code>: Caption</code> syntax, IAL attributes in the caption are extracted and applied to the table:
+</p>
+<pre><code class="highlight language-markdown">| Key | Value |
+| --- | :---: |
+| one |   1   |
+| --- | --- |
+| two |   2   |
+: Key value table {#table-id .testing key="value"}
+</code></pre>
+<p>
+  This is equivalent to:
+</p>
+<pre><code class="highlight language-markdown">| Key | Value |
+| --- | :---: |
+| one |   1   |
+| --- | --- |
+| two |   2   |
+{: #table-id .testing key="value"}
+</code></pre>
+<p>
+  Both Kramdown-style IALs (<code>{: #id .class}</code>) and Pandoc-style IALs without the colon (<code>{#id .class}</code>) are supported in table captions.
+</p>
+<p>
+<strong>  Note:</strong> The <code>: Caption</code> syntax only works when adjacent to a table to avoid conflicts with definition list syntax. See <a href="Syntax.html">Syntax</a> for more details on table captions.
+</p>
+<h2 id="inline-ials">
+  Inline IALs
+</h2>
+<p>
+  Inline IALs appear immediately after the element they apply to, within the same paragraph.
+</p>
+<h3 id="links">
+  Links
+</h3>
+<pre><code class="highlight language-markdown">This is a <span class="p">[</span><span class="nv">regular link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span> without attributes.
+Here's a <span class="p">[</span><span class="nv">styled link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:.button} with a button class.
+Here's a <span class="p">[</span><span class="nv">Pandoc-style link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{#link-id .button} with attributes.
+You can have <span class="p">[</span><span class="nv">multiple links</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:.link-primary} with <span class="p">[</span><span class="nv">different classes</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:.link-secondary} in the same paragraph.
+A link with <span class="p">[</span><span class="nv">custom attributes</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:rel="nofollow" title="External Link"}.
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>This is a <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span><span class="nt">&gt;</span>regular link<span class="nt">&lt;/a&gt;</span> without attributes.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>Here's a <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">class=</span><span class="s">"button"</span><span class="nt">&gt;</span>styled link<span class="nt">&lt;/a&gt;</span> with a button class.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>Here's a <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">id=</span><span class="s">"link-id"</span> <span class="na">class=</span><span class="s">"button"</span><span class="nt">&gt;</span>Pandoc-style link<span class="nt">&lt;/a&gt;</span> with attributes.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>You can have <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">class=</span><span class="s">"link-primary"</span><span class="nt">&gt;</span>multiple links<span class="nt">&lt;/a&gt;</span> with <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">class=</span><span class="s">"link-secondary"</span><span class="nt">&gt;</span>different classes<span class="nt">&lt;/a&gt;</span> in the same paragraph.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>A link with <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">rel=</span><span class="s">"nofollow"</span> <span class="na">title=</span><span class="s">"External Link"</span><span class="nt">&gt;</span>custom attributes<span class="nt">&lt;/a&gt;</span>.<span class="nt">&lt;/p&gt;</span>
+</code></pre>
+<h3 id="images">
+  Images
+</h3>
+<pre><code class="highlight language-markdown"><span class="p">![</span><span class="nv">Regular image</span><span class="p">](</span><span class="sx">image.png</span><span class="p">)</span>
+<span class="p">![</span><span class="nv">Styled image</span><span class="p">](</span><span class="sx">logo.png</span><span class="p">)</span>
+<span class="p">![</span><span class="nv">Image with ID</span><span class="p">](</span><span class="sx">icon.png</span><span class="p">)</span>
+<span class="p">![</span><span class="nv">Image with title</span><span class="p">](</span><span class="sx">photo.jpg</span><span class="p">)</span>
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p&gt;&lt;img</span> <span class="na">src=</span><span class="s">"image.png"</span> <span class="na">alt=</span><span class="s">"Regular image"</span> <span class="nt">/&gt;&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;&lt;img</span> <span class="na">src=</span><span class="s">"logo.png"</span> <span class="na">alt=</span><span class="s">"Styled image"</span> <span class="na">class=</span><span class="s">"logo centered"</span> <span class="nt">/&gt;&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;&lt;img</span> <span class="na">src=</span><span class="s">"icon.png"</span> <span class="na">alt=</span><span class="s">"Image with ID"</span> <span class="na">id=</span><span class="s">"site-icon"</span> <span class="na">class=</span><span class="s">"icon"</span> <span class="nt">/&gt;&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;&lt;img</span> <span class="na">src=</span><span class="s">"photo.jpg"</span> <span class="na">alt=</span><span class="s">"Image with title"</span> <span class="na">title=</span><span class="s">"Photo Title"</span> <span class="na">alt=</span><span class="s">"Photo description"</span> <span class="nt">/&gt;&lt;/p&gt;</span>
+</code></pre>
+<h3 id="emphasis-and-strong">
+  Emphasis and Strong
+</h3>
+<pre><code class="highlight language-markdown">This paragraph has <span class="gs">**bold text**</span>{:.bold-style} with a custom class and <span class="ge">*italic text*</span>{:.italic-style} with another class.
+You can combine <span class="gs">**bold**</span>{:.bold} and <span class="ge">*italic*</span>{:.italic} in the same paragraph with different styles.
+Nested <span class="ge">**</span>bold with <span class="ge">*italic*</span>{:.nested-italic} inside<span class="ge">**</span>{:.bold-wrapper} works too.
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>This paragraph has <span class="nt">&lt;strong</span> <span class="na">class=</span><span class="s">"bold-style"</span><span class="nt">&gt;</span>bold text<span class="nt">&lt;/strong&gt;</span> with a custom class and <span class="nt">&lt;em</span> <span class="na">class=</span><span class="s">"italic-style"</span><span class="nt">&gt;</span>italic text<span class="nt">&lt;/em&gt;</span> with another class.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>You can combine <span class="nt">&lt;strong</span> <span class="na">class=</span><span class="s">"bold"</span><span class="nt">&gt;</span>bold<span class="nt">&lt;/strong&gt;</span> and <span class="nt">&lt;em</span> <span class="na">class=</span><span class="s">"italic"</span><span class="nt">&gt;</span>italic<span class="nt">&lt;/em&gt;</span> in the same paragraph with different styles.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>Nested <span class="nt">&lt;strong</span> <span class="na">class=</span><span class="s">"bold-wrapper"</span><span class="nt">&gt;</span>bold with <span class="nt">&lt;em</span> <span class="na">class=</span><span class="s">"nested-italic"</span><span class="nt">&gt;</span>italic<span class="nt">&lt;/em&gt;</span> inside<span class="nt">&lt;/strong&gt;</span> works too.<span class="nt">&lt;/p&gt;</span>
+</code></pre>
+<h3 id="code-spans">
+  Code Spans
+</h3>
+<pre><code class="highlight language-markdown">Use <span class="sb">`inline code`</span>{:.code-inline} for code snippets with styling.
+You can have multiple <span class="sb">`code spans`</span>{:.code-1} and <span class="sb">`more code`</span>{:.code-2} with different classes.
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p&gt;</span>Use <span class="nt">&lt;code</span> <span class="na">class=</span><span class="s">"code-inline"</span><span class="nt">&gt;</span>inline code<span class="nt">&lt;/code&gt;</span> for code snippets with styling.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>You can have multiple <span class="nt">&lt;code</span> <span class="na">class=</span><span class="s">"code-1"</span><span class="nt">&gt;</span>code spans<span class="nt">&lt;/code&gt;</span> and <span class="nt">&lt;code</span> <span class="na">class=</span><span class="s">"code-2"</span><span class="nt">&gt;</span>more code<span class="nt">&lt;/code&gt;</span> with different classes.<span class="nt">&lt;/p&gt;</span>
+</code></pre>
+<h2 id="attribute-syntax">
+  Attribute Syntax
+</h2>
+<p>
+  IALs support three types of attributes:
+</p>
+<h3 id="1-ids">
+  1. IDs
+</h3>
+<p>
+  Use <code>#</code> followed by the ID name:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Heading {: #section-1}</span>
+</code></pre>
+<p>
+  Output: <code>&lt;h1 id=&quot;section-1&quot;&gt;Heading&lt;/h1&gt;</code>
+</p>
+<h3 id="2-classes">
+  2. Classes
+</h3>
+<p>
+  Use <code>.</code> followed by the class name. Multiple classes can be specified:
+</p>
+<pre><code class="highlight language-markdown">Paragraph.
+{: .important .note .highlight}
+</code></pre>
+<p>
+  Output: <code>&lt;p class=&quot;important note highlight&quot;&gt;Paragraph.&lt;/p&gt;</code>
+</p>
+<p>
+<strong>  Note:</strong> Multiple <code>.class</code> specifiers are equivalent to a single <code>class</code> attribute with space-separated values.
+</p>
+<h3 id="3-key-value-pairs">
+  3. Key-Value Pairs
+</h3>
+<p>
+  Use <code>key=&quot;value&quot;</code> or <code>key='value'</code> for custom attributes. Values can be quoted (single or double quotes) or unquoted:
+</p>
+<pre><code class="highlight language-markdown">Paragraph.
+{: title="Important Note" lang="en" data-id="123"}
+Link with attributes.
+<span class="p">[</span><span class="nv">Click here</span><span class="p">](</span><span class="sx">url</span><span class="p">)</span>{:rel="nofollow" target="_blank"}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;p</span> <span class="na">title=</span><span class="s">"Important Note"</span> <span class="na">lang=</span><span class="s">"en"</span> <span class="na">data-id=</span><span class="s">"123"</span><span class="nt">&gt;</span>Paragraph.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>Link with attributes.
+<span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"url"</span> <span class="na">rel=</span><span class="s">"nofollow"</span> <span class="na">target=</span><span class="s">"_blank"</span><span class="nt">&gt;</span>Click here<span class="nt">&lt;/a&gt;&lt;/p&gt;</span>
+</code></pre>
+<p>
+<strong>  Quoted values:</strong> Use quotes when values contain spaces or special characters:
+</p>
+<pre><code class="highlight language-markdown">
+{: title="This is a title with spaces" lang="en-US"}
+</code></pre>
+<p>
+<strong>  Unquoted values:</strong> Simple values without spaces can be unquoted:
+</p>
+<pre><code class="highlight language-markdown">
+{: lang=en data-visible=true}
+</code></pre>
+<p>
+<strong>  Escaping quotes:</strong> Inside quoted values, escape quotes with backslash:
+</p>
+<pre><code class="highlight language-markdown">
+{: title="He said <span class="se">\"</span>Hello<span class="se">\"</span>"}
+</code></pre>
+<h3 id="combining-attributes">
+  Combining Attributes
+</h3>
+<p>
+  All three types can be combined in a single IAL:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Heading</span>
+{: #section-1 .important .highlight title="Section Title" lang="en"}
+</code></pre>
+<p>
+  Output: <code>&lt;h1 id=&quot;section-1&quot; class=&quot;important highlight&quot; title=&quot;Section Title&quot; lang=&quot;en&quot;&gt;Heading&lt;/h1&gt;</code>
+</p>
+<h2 id="attribute-list-definitions-alds">
+  Attribute List Definitions (ALDs)
+</h2>
+<p>
+  ALDs let you define reusable attribute sets that can be referenced multiple times. This is useful for maintaining consistent styling across a document.
+</p>
+<h3 id="defining-alds">
+  Defining ALDs
+</h3>
+<p>
+  ALDs use the syntax <code>{🚗 attributes}</code> and can appear anywhere in your document (though typically at the end for organization):
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Header 1</span>
+{:header-style}
+<span class="gh"># Header 2</span>
+{:header-style}
+<span class="gh"># Header 3</span>
+{:header-style}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"section-title"</span> <span class="na">class=</span><span class="s">"large bold"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Header 1<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"section-title"</span> <span class="na">class=</span><span class="s">"large bold"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Header 2<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"section-title"</span> <span class="na">class=</span><span class="s">"large bold"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Header 3<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<h3 id="ald-syntax">
+  ALD Syntax
+</h3>
+<p>
+  ALD definitions follow the same attribute syntax as IALs:
+</p>
+<pre lang="markdown"><code></code></pre>
+<h3 id="referencing-alds">
+  Referencing ALDs
+</h3>
+<p>
+  Reference an ALD in an IAL using just the reference name:
+</p>
+<pre><code class="highlight language-markdown"><span class="gh"># Heading</span>
+{:my-style}
+Paragraph.
+{:my-style}
+</code></pre>
+<p>
+  If the ALD <code>{💪 ...}</code> is defined, both elements will receive those attributes.
+</p>
+<h3 id="mixed-usage">
+  Mixed Usage
+</h3>
+<p>
+  You can mix ALD references with additional attributes in the same IAL. The additional attributes override or extend the ALD:
+</p>
+<pre><code class="highlight language-markdown">
+<span class="gh"># Heading 1</span>
+{:base-style}
+<span class="gh"># Heading 2</span>
+{:base-style .class3}
+<span class="gh"># Heading 3</span>
+{:base-style #override-id}
+<span class="gh"># Heading 4</span>
+{:base-style .class3 rel="nofollow"}
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"main"</span> <span class="na">class=</span><span class="s">"class1 class2"</span><span class="nt">&gt;</span>Heading 1<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"main"</span> <span class="na">class=</span><span class="s">"class1 class2 class3"</span><span class="nt">&gt;</span>Heading 2<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"override-id"</span> <span class="na">class=</span><span class="s">"class1 class2"</span><span class="nt">&gt;</span>Heading 3<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"main"</span> <span class="na">class=</span><span class="s">"class1 class2 class3"</span> <span class="na">rel=</span><span class="s">"nofollow"</span><span class="nt">&gt;</span>Heading 4<span class="nt">&lt;/h1&gt;</span>
+</code></pre>
+<p>
+<strong>  Behavior:</strong>
+</p>
+<ul>
+  <li>
+<strong>    Classes</strong>: Additional classes are appended to the ALD classes
+  </li>
+  <li>
+<strong>    IDs</strong>: If an ID is specified in the IAL, it overrides the ALD’s ID
+  </li>
+  <li>
+<strong>    Key-value attributes</strong>: If a key exists in both ALD and IAL, the IAL value overrides the ALD value
+  </li>
+</ul>
+<h2 id="important-notes">
+  Important Notes
+</h2>
+<h3 id="block-level-ial-positioning">
+  Block-Level IAL Positioning
+</h3>
+<p>
+  For block-level elements, the IAL <strong>must</strong> appear immediately after the element with <strong>no blank line</strong> between them:
+</p>
+<p>
+<strong>  Correct:</strong>
+</p>
+<pre><code class="highlight language-markdown">Paragraph text.
+{: .class}
+</code></pre>
+<p>
+<strong>  Incorrect:</strong>
+</p>
+<pre><code class="highlight language-markdown">Paragraph text.
+{: .class}
+</code></pre>
+<p>
+  The blank line will cause the IAL to be treated as a separate paragraph.
+</p>
+<h3 id="inline-ial-positioning">
+  Inline IAL Positioning
+</h3>
+<p>
+  For inline elements, the IAL must appear immediately after the element, with optional whitespace:
+</p>
+<pre><code class="highlight language-markdown"><span class="p">[</span><span class="nv">link</span><span class="p">](</span><span class="sx">url</span><span class="p">)</span>{:.class} text after
+<span class="gs">**bold**</span>{:.bold-style} more text
+</code></pre>
+<h3 id="multiple-elements-with-same-attributes">
+  Multiple Elements with Same Attributes
+</h3>
+<p>
+  When multiple links share the same URL, IALs are correctly matched using element indexing:
+</p>
+<pre><code class="highlight language-markdown">Here's a <span class="p">[</span><span class="nv">regular link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span> and <span class="p">[</span><span class="nv">another link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:.button}.
+</code></pre>
+<p>
+  Both links point to the same URL, but only the second one receives the <code>button</code> class.
+</p>
+<h3 id="nested-elements">
+  Nested Elements
+</h3>
+<p>
+  IALs work with nested inline elements:
+</p>
+<pre><code class="highlight language-markdown"><span class="ge">**</span>Bold text with <span class="ge">*italic*</span>{:.nested} inside<span class="ge">**</span>{:.wrapper}
+</code></pre>
+<p>
+  The italic element gets the <code>nested</code> class, and the bold element gets the <code>wrapper</code> class.
+</p>
+<h2 id="examples">
+  Examples
+</h2>
+<h3 id="complete-example">
+  Complete Example
+</h3>
+<pre><code class="highlight language-markdown"><span class="gh"># Main Title</span>
+{: #main-title .page-title}
+<span class="gu">## Section 1</span>
+{:section-heading}
+This paragraph has <span class="p">[</span><span class="nv">a link</span><span class="p">](</span><span class="sx">https://example.com</span><span class="p">)</span>{:.external-link} with styling.
+Another paragraph with <span class="gs">**bold text**</span>{:.highlight}.
+<span class="gu">## Section 2</span>
+{:section-heading}
+More content here.
+</code></pre>
+<p>
+  Output:
+</p>
+<pre><code class="highlight language-html"><span class="nt">&lt;h1</span> <span class="na">id=</span><span class="s">"main-title"</span> <span class="na">class=</span><span class="s">"page-title"</span><span class="nt">&gt;</span>Main Title<span class="nt">&lt;/h1&gt;</span>
+<span class="nt">&lt;h2</span> <span class="na">class=</span><span class="s">"section important"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Section 1<span class="nt">&lt;/h2&gt;</span>
+<span class="nt">&lt;p&gt;</span>This paragraph has <span class="nt">&lt;a</span> <span class="na">href=</span><span class="s">"https://example.com"</span> <span class="na">class=</span><span class="s">"external-link"</span><span class="nt">&gt;</span>a link<span class="nt">&lt;/a&gt;</span> with styling.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;p&gt;</span>Another paragraph with <span class="nt">&lt;strong</span> <span class="na">class=</span><span class="s">"highlight"</span><span class="nt">&gt;</span>bold text<span class="nt">&lt;/strong&gt;</span>.<span class="nt">&lt;/p&gt;</span>
+<span class="nt">&lt;h2</span> <span class="na">class=</span><span class="s">"section important"</span> <span class="na">lang=</span><span class="s">"en"</span><span class="nt">&gt;</span>Section 2<span class="nt">&lt;/h2&gt;</span>
+<span class="nt">&lt;p&gt;</span>More content here.<span class="nt">&lt;/p&gt;</span>
+</code></pre>
+<h3 id="using-alds-for-consistent-styling">
+  Using ALDs for Consistent Styling
+</h3>
+<pre><code class="highlight language-markdown"><span class="gh"># Introduction</span>
+{:intro}
+<span class="gu">## Overview</span>
+{:intro}
+<span class="gu">## Details</span>
+{:intro}
+<span class="gh"># Conclusion</span>
+{:conclusion}
+<span class="gu">## Summary</span>
+{:conclusion}
+</code></pre>
+<p>
+  This allows you to maintain consistent styling across multiple elements by defining the attributes once and referencing them multiple times.
+</p>
+<h2 id="related">
+  Related
+</h2>
+<ul>
+  <li>
+<a href="Syntax.html">    Syntax</a> - Complete syntax reference
+  </li>
+  <li>
+<a href="Modes.html">    Modes</a> - Understanding processor modes (IALs available in Kramdown and unified modes)
+  </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>