apex-ruby 1.0.17 → 1.0.20

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 (207) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +17 -3
  3. data/ext/apex_ext/apex_ext.c +260 -91
  4. data/ext/apex_ext/apex_src/CHANGELOG.md +440 -0
  5. data/ext/apex_ext/apex_src/CMakeLists.txt +15 -1
  6. data/ext/apex_ext/apex_src/Formula/apex.rb +7 -2
  7. data/ext/apex_ext/apex_src/Package.swift +15 -4
  8. data/ext/apex_ext/apex_src/README.md +94 -35
  9. data/ext/apex_ext/apex_src/VERSION +1 -1
  10. data/ext/apex_ext/apex_src/apex-debug.log +4 -0
  11. data/ext/apex_ext/apex_src/apex.code-workspace +38 -0
  12. data/ext/apex_ext/apex_src/apex.taskpaper +12 -0
  13. data/ext/apex_ext/apex_src/apex_deflist_debug.log +25 -0
  14. data/ext/apex_ext/apex_src/buildnotes.md +1435 -0
  15. data/ext/apex_ext/apex_src/cli/main.c +262 -33
  16. data/ext/apex_ext/apex_src/debug.log +7 -0
  17. data/ext/apex_ext/apex_src/docs/CITATIONS_EXAMPLES.md +274 -0
  18. data/ext/apex_ext/apex_src/docs/CITATIONS_IMPLEMENTATION_PLAN.md +749 -0
  19. data/ext/apex_ext/apex_src/docs/CITATIONS_PLAN.md +744 -0
  20. data/ext/apex_ext/apex_src/docs/INDEX_IMPLEMENTATION_ANALYSIS.md +382 -0
  21. data/ext/apex_ext/apex_src/docs/plans/2025-02-27-man-page-output-implementation.md +351 -0
  22. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-12-toc-output-format.md +745 -0
  23. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-18-bear-image-attributes.md +829 -0
  24. data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-19-apex-node-npm.md +1148 -0
  25. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-12-toc-output-format-design.md +161 -0
  26. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-18-bear-image-attributes-design.md +184 -0
  27. data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-19-apex-node-npm-design.md +211 -0
  28. data/ext/apex_ext/apex_src/documentation/app-settings-table.md +67 -0
  29. data/ext/apex_ext/apex_src/documentation/app-transformed/Citations.md +340 -0
  30. data/ext/apex_ext/apex_src/documentation/app-transformed/Credits.md +11 -0
  31. data/ext/apex_ext/apex_src/documentation/app-transformed/Header-IDs.md +234 -0
  32. data/ext/apex_ext/apex_src/documentation/app-transformed/Inline-Attribute-Lists.md +516 -0
  33. data/ext/apex_ext/apex_src/documentation/app-transformed/Metadata-Transforms.md +461 -0
  34. data/ext/apex_ext/apex_src/documentation/app-transformed/Modes.md +193 -0
  35. data/ext/apex_ext/apex_src/documentation/app-transformed/Multi-File-Documents.md +201 -0
  36. data/ext/apex_ext/apex_src/documentation/app-transformed/Plugins.md +678 -0
  37. data/ext/apex_ext/apex_src/documentation/app-transformed/Syntax.md +1367 -0
  38. data/ext/apex_ext/apex_src/documentation/docsets/Apex Command Line Options.cheatsheet.txt +6 -0
  39. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/C-API.html +774 -300
  40. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Callouts.html +1194 -0
  41. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Citations.html +416 -216
  42. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Command-Line-Options.html +3544 -1094
  43. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Configuration.html +371 -97
  44. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Credits.html +153 -23
  45. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html +358 -124
  46. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Filters.html +1656 -0
  47. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Generating-Man-Pages.html +1226 -0
  48. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Getting-Started.html +201 -56
  49. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html +279 -109
  50. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Home.html +200 -53
  51. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Indices.html +2327 -0
  52. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Inline-Attribute-Lists.html +690 -271
  53. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Installation.html +201 -55
  54. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html +238 -68
  55. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Metadata-Transforms.html +421 -221
  56. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Modes.html +340 -78
  57. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html +251 -86
  58. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-Format-Images.html +1362 -0
  59. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Pandoc-Integration.html +277 -90
  60. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Plugins.html +673 -346
  61. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Quarto-Mode.html +1405 -0
  62. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Rendering-Markdown-In-Terminal.html +1902 -0
  63. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Syntax.html +1939 -1698
  64. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Tables.html +1781 -0
  65. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Troubleshooting.html +315 -140
  66. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html +307 -113
  67. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Using-Apex-with-Jekyll.html +1132 -0
  68. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Writing-Tests.html +1754 -0
  69. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Xcode-Integration.html +872 -376
  70. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/docSet.dsidx +0 -0
  71. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/optimizedIndex.dsidx +0 -0
  72. data/ext/apex_ext/apex_src/documentation/html/apex-app-docs.html +8746 -0
  73. data/ext/apex_ext/apex_src/documentation/shared_styles.css +20 -15
  74. data/ext/apex_ext/apex_src/documentation/transform_for_app.md +55 -0
  75. data/ext/apex_ext/apex_src/escaping-repro.md +103 -0
  76. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/Info.plist +8 -0
  77. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/QuickLook/Preview.png +0 -0
  78. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/document.wflow +547 -0
  79. data/ext/apex_ext/apex_src/examples/quick-actions/Markdown-to-RTF.workflow.zip +0 -0
  80. data/ext/apex_ext/apex_src/examples/quick-actions/README.md +33 -0
  81. data/ext/apex_ext/apex_src/include/apex/apex.h +92 -6
  82. data/ext/apex_ext/apex_src/include/apex/ast_rtf.h +23 -0
  83. data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +6 -0
  84. data/ext/apex_ext/apex_src/include/apex/module.modulemap +5 -0
  85. data/ext/apex_ext/apex_src/include/apex/plugins.h +105 -0
  86. data/ext/apex_ext/apex_src/include/apexc.h +1 -0
  87. data/ext/apex_ext/apex_src/man/apex.1 +82 -78
  88. data/ext/apex_ext/apex_src/man/apex.1.md +81 -4
  89. data/ext/apex_ext/apex_src/objc/Apex.swift +73 -0
  90. data/ext/apex_ext/apex_src/objc/ApexPlugins.swift +79 -0
  91. data/ext/apex_ext/apex_src/objc/NSString+Apex.h +83 -5
  92. data/ext/apex_ext/apex_src/objc/NSString+Apex.m +244 -1
  93. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.h +76 -0
  94. data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.m +169 -0
  95. data/ext/apex_ext/apex_src/output.html +87 -0
  96. data/ext/apex_ext/apex_src/plans/quarto-mode.md +442 -0
  97. data/ext/apex_ext/apex_src/src/_README.md +85 -32
  98. data/ext/apex_ext/apex_src/src/apex.c +770 -200
  99. data/ext/apex_ext/apex_src/src/ast_rtf.c +848 -0
  100. data/ext/apex_ext/apex_src/src/ast_terminal.c +184 -7
  101. data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +10 -3
  102. data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +7 -11
  103. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.c +467 -0
  104. data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.h +27 -0
  105. data/ext/apex_ext/apex_src/src/extensions/callouts.c +400 -4
  106. data/ext/apex_ext/apex_src/src/extensions/callouts.h +15 -5
  107. data/ext/apex_ext/apex_src/src/extensions/citations.c +26 -5
  108. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.c +632 -0
  109. data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.h +22 -0
  110. data/ext/apex_ext/apex_src/src/extensions/concordance.c +632 -0
  111. data/ext/apex_ext/apex_src/src/extensions/definition_list.c +129 -15
  112. data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1050 -121
  113. data/ext/apex_ext/apex_src/src/extensions/html_markdown.c +569 -16
  114. data/ext/apex_ext/apex_src/src/extensions/ial.c +502 -52
  115. data/ext/apex_ext/apex_src/src/extensions/ial.h +2 -1
  116. data/ext/apex_ext/apex_src/src/extensions/includes.c +532 -33
  117. data/ext/apex_ext/apex_src/src/extensions/includes.h +7 -1
  118. data/ext/apex_ext/apex_src/src/extensions/index.c +1427 -140
  119. data/ext/apex_ext/apex_src/src/extensions/index.h +28 -0
  120. data/ext/apex_ext/apex_src/src/extensions/metadata.c +200 -161
  121. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.c +251 -0
  122. data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.h +22 -0
  123. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.c +624 -0
  124. data/ext/apex_ext/apex_src/src/extensions/quarto_lists.h +35 -0
  125. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.c +264 -0
  126. data/ext/apex_ext/apex_src/src/extensions/quarto_polish.h +23 -0
  127. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.c +307 -0
  128. data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.h +21 -0
  129. data/ext/apex_ext/apex_src/src/extensions/raw_content.c +351 -0
  130. data/ext/apex_ext/apex_src/src/extensions/raw_content.h +20 -0
  131. data/ext/apex_ext/apex_src/src/extensions/relaxed_tables.c +117 -3
  132. data/ext/apex_ext/apex_src/src/extensions/special_markers.c +53 -0
  133. data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +23 -1
  134. data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +83 -92
  135. data/ext/apex_ext/apex_src/src/extensions/toc.c +446 -25
  136. data/ext/apex_ext/apex_src/src/extensions/toc.h +26 -1
  137. data/ext/apex_ext/apex_src/src/extensions/wiki_links.c +28 -0
  138. data/ext/apex_ext/apex_src/src/html_renderer.c +387 -17
  139. data/ext/apex_ext/apex_src/src/plugin_catalog.c +517 -0
  140. data/ext/apex_ext/apex_src/src/plugins_remote.c +88 -14
  141. data/ext/apex_ext/apex_src/src/plugins_remote.h +34 -0
  142. data/ext/apex_ext/apex_src/src/pretty_html.c +6 -1
  143. data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +21 -0
  144. data/ext/apex_ext/apex_src/tests/fixtures/images/bear_image_attributes.md +10 -0
  145. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.md +19 -0
  146. data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.txt +11 -0
  147. data/ext/apex_ext/apex_src/tests/fixtures/minimal_pb.md +2 -0
  148. data/ext/apex_ext/apex_src/tests/fixtures/obsidian-callouts.md +46 -0
  149. data/ext/apex_ext/apex_src/tests/fixtures/pagebreak_html_repro.md +5 -0
  150. data/ext/apex_ext/apex_src/tests/fixtures/python-callouts.md +47 -0
  151. data/ext/apex_ext/apex_src/tests/fixtures/quarto/callouts.md +3 -0
  152. data/ext/apex_ext/apex_src/tests/fixtures/quarto/code-attrs.md +3 -0
  153. data/ext/apex_ext/apex_src/tests/fixtures/quarto/diagrams.md +8 -0
  154. data/ext/apex_ext/apex_src/tests/fixtures/quarto/lists.md +19 -0
  155. data/ext/apex_ext/apex_src/tests/fixtures/quarto/raw-content.md +5 -0
  156. data/ext/apex_ext/apex_src/tests/fixtures/quarto/shortcodes.md +7 -0
  157. data/ext/apex_ext/apex_src/tests/fixtures/quarto/smoke.md +81 -0
  158. data/ext/apex_ext/apex_src/tests/fixtures/quarto/spans.md +5 -0
  159. data/ext/apex_ext/apex_src/tests/fixtures/quarto-callouts.md +47 -0
  160. data/ext/apex_ext/apex_src/tests/fixtures/speed.md +192 -0
  161. data/ext/apex_ext/apex_src/tests/fixtures/tables/grid-tables.md +37 -0
  162. data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +16 -0
  163. data/ext/apex_ext/apex_src/tests/test_bear_image_attrs.c +301 -0
  164. data/ext/apex_ext/apex_src/tests/test_concordance.tsv +4 -0
  165. data/ext/apex_ext/apex_src/tests/test_escaping_repro.c +82 -0
  166. data/ext/apex_ext/apex_src/tests/test_extensions.c +821 -1
  167. data/ext/apex_ext/apex_src/tests/test_ial.c +7 -0
  168. data/ext/apex_ext/apex_src/tests/test_marked_integration.c +25 -0
  169. data/ext/apex_ext/apex_src/tests/test_metadata.c +129 -0
  170. data/ext/apex_ext/apex_src/tests/test_output.c +568 -2
  171. data/ext/apex_ext/apex_src/tests/test_runner.c +11 -0
  172. data/ext/apex_ext/apex_src/tests/test_tables.c +420 -0
  173. data/ext/apex_ext/apex_src/vendor/cmark-gfm/CMakeLists.txt +1 -1
  174. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/autolink.c +77 -1
  175. data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/table.c +135 -5
  176. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/blocks.c +56 -1
  177. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/config.h +38 -0
  178. data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/main.c +1 -1
  179. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/cmark.cpython-314.pyc +0 -0
  180. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/normalize.cpython-314.pyc +0 -0
  181. data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/extensions.txt +69 -0
  182. data/ext/apex_ext/apex_src/xcode_build/CMakeScripts/ReRunCMake.make +74 -0
  183. data/ext/apex_ext/apex_src/xcode_build/CTestTestfile.cmake +22 -0
  184. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Apex +0 -0
  185. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Resources/Info.plist +44 -0
  186. data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/_CodeSignature/CodeResources +128 -0
  187. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.pbxproj +5118 -0
  188. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  189. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/UserInterfaceState.xcuserstate +0 -0
  190. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/WorkspaceSettings.xcsettings +8 -0
  191. data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/xcuserdata/ttscoff.xcuserdatad/xcschemes/xcschememanagement.plist +99 -0
  192. data/ext/apex_ext/apex_src/xcode_build/cmake_install.cmake +452 -0
  193. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/CMakeScripts/ReRunCMake.make +52 -0
  194. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmake_install.cmake +55 -0
  195. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.pbxproj +2455 -0
  196. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
  197. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/extensions/cmake_install.cmake +171 -0
  198. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/man/cmake_install.cmake +55 -0
  199. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmake_install.cmake +220 -0
  200. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_export.h +43 -0
  201. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_version.h +7 -0
  202. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/config.h +76 -0
  203. data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/libcmark-gfm.pc +10 -0
  204. data/ext/apex_ext/extconf.rb +35 -0
  205. data/lib/apex/version.rb +2 -2
  206. metadata +117 -2
  207. data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/tempOptimizedIndex.dsidx +0 -0
@@ -0,0 +1,1781 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+
4
+ <head>
5
+
6
+ <meta charset="UTF-8">
7
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
8
+ <meta name="generator" content="Apex 1.1.12">
9
+ <title>Document</title>
10
+ <style>
11
+ /* GitHub-style syntax highlighting for Pygments and Skylighting */
12
+ /* Don't apply background to wrapper when code highlighting is enabled - let default styles handle it */
13
+ .code-highlighted .highlight, .code-highlighted .sourceCode { background: inherit; border-radius: 6px; padding: 16px; overflow-x: auto; }
14
+ .highlight pre, .sourceCode pre { margin: 0; padding: 0; background: transparent; }
15
+ .highlight code, .sourceCode code { font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace; font-size: 12px; line-height: 1.45; }
16
+ /* Pygments classes */
17
+ .highlight .k { color: #d73a49; font-weight: 600; } /* Keyword */
18
+ .highlight .kt { color: #d73a49; } /* Keyword.Type */
19
+ .highlight .kd { color: #d73a49; font-weight: 600; } /* Keyword.Declaration */
20
+ .highlight .kn { color: #d73a49; } /* Keyword.Namespace */
21
+ .highlight .kp { color: #d73a49; } /* Keyword.Pseudo */
22
+ .highlight .kr { color: #d73a49; font-weight: 600; } /* Keyword.Reserved */
23
+ .highlight .n { color: #6f42c1; } /* Name */
24
+ .highlight .na { color: #6f42c1; } /* Name.Attribute */
25
+ .highlight .nc { color: #6f42c1; font-weight: 600; } /* Name.Class */
26
+ .highlight .no { color: #005cc5; } /* Name.Constant */
27
+ .highlight .nd { color: #6f42c1; font-weight: 600; } /* Name.Decorator */
28
+ .highlight .ni { color: #800080; } /* Name.Entity */
29
+ .highlight .ne { color: #990000; font-weight: 600; } /* Name.Exception */
30
+ .highlight .nf { color: #6f42c1; font-weight: 600; } /* Name.Function */
31
+ .highlight .nl { color: #6f42c1; } /* Name.Label */
32
+ .highlight .nn { color: #555; } /* Name.Namespace */
33
+ .highlight .nt { color: #22863a; } /* Name.Tag */
34
+ .highlight .nv { color: #e36209; } /* Name.Variable */
35
+ .highlight .s { color: #032f62; } /* String */
36
+ .highlight .sb { color: #032f62; } /* String.Backtick */
37
+ .highlight .sc { color: #032f62; } /* String.Char */
38
+ .highlight .sd { color: #032f62; } /* String.Doc */
39
+ .highlight .s2 { color: #032f62; } /* String.Double */
40
+ .highlight .se { color: #032f62; } /* String.Escape */
41
+ .highlight .sh { color: #032f62; } /* String.Heredoc */
42
+ .highlight .si { color: #032f62; } /* String.Interpol */
43
+ .highlight .sx { color: #032f62; } /* String.Other */
44
+ .highlight .sr { color: #032f62; } /* String.Regex */
45
+ .highlight .s1 { color: #032f62; } /* String.Single */
46
+ .highlight .ss { color: #032f62; } /* String.Symbol */
47
+ .highlight .c { color: #6a737d; font-style: italic; } /* Comment */
48
+ .highlight .c1 { color: #6a737d; font-style: italic; } /* Comment.Single */
49
+ .highlight .cm { color: #6a737d; font-style: italic; } /* Comment.Multiline */
50
+ .highlight .cp { color: #6a737d; font-weight: 600; } /* Comment.Preproc */
51
+ .highlight .cs { color: #6a737d; font-weight: 600; font-style: italic; } /* Comment.Special */
52
+ .highlight .m { color: #005cc5; } /* Literal.Number */
53
+ .highlight .mb { color: #005cc5; } /* Literal.Number.Bin */
54
+ .highlight .mf { color: #005cc5; } /* Literal.Number.Float */
55
+ .highlight .mh { color: #005cc5; } /* Literal.Number.Hex */
56
+ .highlight .mi { color: #005cc5; } /* Literal.Number.Integer */
57
+ .highlight .il { color: #005cc5; } /* Literal.Number.Integer.Long */
58
+ .highlight .mo { color: #005cc5; } /* Literal.Number.Oct */
59
+ .highlight .o { color: #d73a49; } /* Operator */
60
+ .highlight .ow { color: #d73a49; } /* Operator.Word */
61
+ .highlight .p { color: #24292e; } /* Punctuation */
62
+ .highlight .w { color: #e1e4e8; } /* Text.Whitespace */
63
+ /* Skylighting classes */
64
+ .sourceCode .kw { color: #d73a49; font-weight: 600; } /* Keyword */
65
+ .sourceCode .dt { color: #6f42c1; } /* DataType */
66
+ .sourceCode .dv { color: #005cc5; } /* DecVal */
67
+ .sourceCode .bn { color: #005cc5; } /* BaseN */
68
+ .sourceCode .fl { color: #005cc5; } /* Float */
69
+ .sourceCode .ch { color: #032f62; } /* Char */
70
+ .sourceCode .st { color: #032f62; } /* String */
71
+ .sourceCode .co { color: #6a737d; font-style: italic; } /* Comment */
72
+ .sourceCode .ot { color: #22863a; } /* Other */
73
+ .sourceCode .al { color: #e36209; font-weight: 600; } /* Alert */
74
+ .sourceCode .fu { color: #6f42c1; font-weight: 600; } /* Function */
75
+ .sourceCode .re { color: #032f62; } /* RegionMarker */
76
+ .sourceCode .er { color: #d73a49; font-weight: 600; } /* Error */
77
+ .sourceCode .cf { color: #d73a49; font-weight: 600; } /* ControlFlow */
78
+ .sourceCode .op { color: #d73a49; } /* Operator */
79
+ .sourceCode .pp { color: #6a737d; } /* Preprocessor */
80
+ .sourceCode .at { color: #005cc5; } /* Attribute */
81
+ .sourceCode .do { color: #6a737d; font-style: italic; } /* Documentation */
82
+ .sourceCode .an { color: #6a737d; font-weight: 600; } /* Annotation */
83
+ .sourceCode .cv { color: #6a737d; font-weight: 600; font-style: italic; } /* CommentVar */
84
+ .sourceCode .in { color: #6a737d; } /* Information */
85
+ .sourceCode .wa { color: #e36209; font-weight: 600; } /* Warning */
86
+ .sourceCode .im { color: #d73a49; } /* Import */
87
+ .sourceCode .bu { color: #005cc5; } /* BuiltIn */
88
+ .sourceCode .ex { color: #6f42c1; } /* Extension */
89
+ .sourceCode .va { color: #e36209; } /* Variable */
90
+ .sourceCode .ss { color: #032f62; } /* SpecialString */
91
+ .sourceCode .sc { color: #032f62; } /* SpecialChar */
92
+ .sourceCode .vs { color: #032f62; } /* VerbatimString */
93
+ .sourceCode .il { color: #005cc5; } /* Special */
94
+ /* Line numbers (Skylighting) */
95
+ .sourceCode.numberSource .sourceCode { counter-reset: line; }
96
+ .sourceCode.numberSource .sourceCode > span { position: relative; left: -4em; counter-increment: line; }
97
+ .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; }
98
+ </style>
99
+ <style>
100
+ body {
101
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
102
+ line-height: 1.6;
103
+ max-width: 800px;
104
+ margin: 2rem auto;
105
+ padding: 0 1rem;
106
+ color: #333;
107
+ }
108
+ pre { background: #f5f5f5; padding: 1rem; overflow-x: auto; }
109
+ code { background: #f0f0f0; padding: 0.2em 0.4em; border-radius: 3px; }
110
+ blockquote { border-left: 4px solid #ddd; margin: 0; padding-left: 1rem; color: #666; }
111
+ table { border-collapse: collapse; width: 100%%; }
112
+ th, td { border: 1px solid #ddd; padding: 0.5rem; }
113
+ th { background: #f5f5f5; }
114
+ tfoot td { background: #e8e8e8; }
115
+ figure.table-figure { width: fit-content; margin: 1em 0; }
116
+ figure.table-figure table { width: auto; }
117
+ figcaption { text-align: center; font-weight: bold; font-size: 0.8em; }
118
+ .page-break { page-break-after: always; }
119
+ .callout { padding: 1rem; margin: 1rem 0; border-left: 4px solid; }
120
+ .callout-note { border-color: #3b82f6; background: #eff6ff; }
121
+ .callout-warning { border-color: #f59e0b; background: #fffbeb; }
122
+ .callout-tip { border-color: #10b981; background: #f0fdf4; }
123
+ .callout-danger { border-color: #ef4444; background: #fef2f2; }
124
+ ins { background: #d4fcbc; text-decoration: none; }
125
+ del { background: #fbb6c2; text-decoration: line-through; }
126
+ mark { background: #fff3cd; }
127
+ .smallcaps { font-variant: small-caps; }
128
+ .underline { text-decoration: underline; }
129
+ span.mark { background: #fff3cd; }
130
+ .hidden { display: none; }
131
+ .quarto-xref { font-variant: normal; }
132
+ .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
133
+ .mkhashtag { color: #666; }
134
+ .mkstyledtag {
135
+ display: inline-block;
136
+ background: #e0e0e0;
137
+ padding: 3px 9px;
138
+ border-radius: 20px;
139
+ font-size: 0.9em;
140
+ line-height: 1.4;
141
+ color: #333;
142
+ margin: 0 2px;
143
+ }
144
+ </style>
145
+ <meta name="paginate" content="symbols"/>
146
+ <meta name="highlight-language-only" content="true"/>
147
+ <meta name="code-line-numbers" content="false"/>
148
+ <meta name="code-highlight" content="pygments"/>
149
+ <meta name="sup-sub" content="true"/>
150
+ <meta name="relaxed-tables" content="true"/>
151
+ <meta name="includes" content="true"/>
152
+ <meta name="autolink" content="true"/>
153
+ <meta name="pretty" content="false"/>
154
+ <meta name="standalone" content="false"/>
155
+ <meta name="mode" content="unified"/>
156
+ <meta name="markdown-in-html" content="true"/>
157
+ <meta name="image-captions" content="true"/>
158
+ <meta name="wikilink-extension" content="html"/>
159
+ <meta name="wikilink-space" content="hyphen"/>
160
+ <meta name="wikilinks" content="true"/>
161
+ <meta name="widont" content="true"/>
162
+ <meta name="plugins" content="true"/>
163
+ <meta name="id-format" content="gfm"/>
164
+
165
+ <style>
166
+ :root {
167
+ /* border-box width of the fixed sidebar; body offset includes a small gap */
168
+ --sidebar-width: 250px;
169
+ --sidebar-offset: 270px;
170
+ }
171
+
172
+ /* Base styles — override Apex standalone centering (max-width + margin: auto) */
173
+ body {
174
+ -webkit-font-smoothing: antialiased;
175
+ -moz-osx-font-smoothing: grayscale;
176
+ font-size: 17px;
177
+ font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
178
+ "Helvetica Neue", Arial, sans-serif;
179
+ line-height: 1.65;
180
+ color: #1e293b;
181
+ background-color: #fff;
182
+ max-width: none;
183
+ width: auto;
184
+ margin: 2rem 2rem 2rem var(--sidebar-offset);
185
+ padding: 0 1rem;
186
+ box-sizing: border-box;
187
+ }
188
+
189
+ /* Sidebar / Main TOC - wider on larger screens */
190
+ .main-toc,
191
+ .sidebar {
192
+ position: fixed;
193
+ left: 0;
194
+ top: 0;
195
+ box-sizing: border-box;
196
+ width: var(--sidebar-width);
197
+ min-width: var(--sidebar-width);
198
+ max-width: var(--sidebar-width);
199
+ height: 100vh;
200
+ overflow-y: auto;
201
+ background: #1e293b;
202
+ color: rgba(255, 255, 255, 0.9);
203
+ border-right: 2px solid rgba(255, 255, 255, 0.1);
204
+ padding: 24px 20px 130px;
205
+ font-size: 14px;
206
+ z-index: 100;
207
+ box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
208
+ transition: transform 0.3s ease;
209
+ }
210
+
211
+ .main-toc ul,
212
+ .sidebar ul {
213
+ list-style: none;
214
+ padding-left: 0;
215
+ margin: 0;
216
+ padding-bottom: 80px;
217
+ }
218
+
219
+ .main-toc ul::after,
220
+ .sidebar ul::after {
221
+ content: "";
222
+ display: block;
223
+ height: 80px;
224
+ }
225
+
226
+ .main-toc li,
227
+ .sidebar li {
228
+ margin: 0.25em 0;
229
+ }
230
+
231
+ .main-toc a,
232
+ .sidebar a {
233
+ color: rgba(255, 255, 255, 0.85);
234
+ text-decoration: none;
235
+ display: block;
236
+ padding: 6px 12px;
237
+ border-radius: 4px;
238
+ transition: all 0.15s ease;
239
+ white-space: nowrap;
240
+ overflow: hidden;
241
+ text-overflow: ellipsis;
242
+ }
243
+
244
+ .main-toc a:hover,
245
+ .sidebar a:hover {
246
+ background: #334155;
247
+ color: #fff;
248
+ }
249
+
250
+ .sidebar a.active {
251
+ color: #0ea5e9;
252
+ font-weight: 500;
253
+ }
254
+
255
+ /* Hamburger menu button */
256
+ .hamburger-menu {
257
+ display: none;
258
+ position: fixed;
259
+ top: 12px;
260
+ left: 12px;
261
+ z-index: 200;
262
+ background: #1e293b;
263
+ border: 2px solid rgba(255, 255, 255, 0.1);
264
+ border-radius: 6px;
265
+ padding: 10px;
266
+ cursor: pointer;
267
+ color: rgba(255, 255, 255, 0.9);
268
+ font-size: 20px;
269
+ line-height: 1;
270
+ box-sizing: border-box;
271
+ width: 44px;
272
+ height: 44px;
273
+ align-items: center;
274
+ justify-content: center;
275
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);
276
+ transition: all 0.2s ease;
277
+ opacity: 0.2;
278
+ }
279
+
280
+ .hamburger-menu:hover {
281
+ background: #334155;
282
+ color: #fff;
283
+ opacity: 1;
284
+ }
285
+
286
+ /* Move hamburger to the right of the sidebar when menu is open */
287
+ .hamburger-menu.active {
288
+ left: calc(var(--sidebar-width) + 12px);
289
+ }
290
+
291
+ .hamburger-menu.active {
292
+ background: #0ea5e9;
293
+ }
294
+
295
+ .hamburger-menu::before {
296
+ content: "☰";
297
+ }
298
+
299
+ .hamburger-menu.active::before {
300
+ content: "✕";
301
+ }
302
+
303
+ /* Mobile menu overlay */
304
+ .mobile-menu-overlay {
305
+ display: none;
306
+ position: fixed;
307
+ top: 0;
308
+ left: 0;
309
+ right: 0;
310
+ bottom: 0;
311
+ background: rgba(0, 0, 0, 0.5);
312
+ z-index: 150;
313
+ opacity: 0;
314
+ visibility: hidden;
315
+ transition: opacity 0.3s ease, visibility 0.3s ease;
316
+ }
317
+
318
+ .mobile-menu-overlay.active {
319
+ opacity: 1;
320
+ visibility: visible;
321
+ }
322
+
323
+ /* Page TOC */
324
+ .page-toc {
325
+ background: #f9f9f9;
326
+ border: 1px solid #ddd;
327
+ border-radius: 4px;
328
+ padding: 1rem;
329
+ margin: 1.5rem 0;
330
+ }
331
+
332
+ .page-toc ul {
333
+ list-style: none;
334
+ padding-left: 0;
335
+ margin: 0;
336
+ }
337
+
338
+ .page-toc > ul {
339
+ padding-left: 0;
340
+ }
341
+
342
+ .page-toc li {
343
+ margin: 0.25em 0;
344
+ }
345
+
346
+ .page-toc a {
347
+ color: #0066cc;
348
+ text-decoration: none;
349
+ display: block;
350
+ padding: 0.25em 0.5em;
351
+ border-radius: 3px;
352
+ }
353
+
354
+ .page-toc a:hover {
355
+ background: #e0e0e0;
356
+ color: #004499;
357
+ }
358
+
359
+ .page-toc ul ul {
360
+ list-style: none;
361
+ padding-left: 1.5em;
362
+ margin-top: 0.25em;
363
+ margin-left: 0;
364
+ }
365
+
366
+ .page-toc ul ul ul {
367
+ padding-left: 1.5em;
368
+ }
369
+
370
+ .page-toc ul ul a {
371
+ font-size: 0.9em;
372
+ color: #555;
373
+ }
374
+
375
+ .page-toc ul ul ul a {
376
+ font-size: 0.85em;
377
+ color: #666;
378
+ }
379
+
380
+ /* Floating TOC */
381
+ .floating-toc {
382
+ position: fixed;
383
+ top: 0;
384
+ left: var(--sidebar-offset);
385
+ right: 0;
386
+ z-index: 50;
387
+ opacity: 0;
388
+ visibility: hidden;
389
+ transition: opacity 0.2s ease, visibility 0.2s ease;
390
+ pointer-events: none;
391
+ display: flex;
392
+ justify-content: flex-end;
393
+ padding-right: 2rem;
394
+ }
395
+
396
+ .floating-toc.visible {
397
+ opacity: 1;
398
+ visibility: visible;
399
+ pointer-events: auto;
400
+ }
401
+
402
+ .floating-toc-container {
403
+ background: rgba(255, 255, 255, 0.95);
404
+ backdrop-filter: blur(10px);
405
+ border-bottom: 1px solid #ddd;
406
+ border-radius: 0 0 12px 12px;
407
+ box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
408
+ width: fit-content;
409
+ max-width: 400px;
410
+ min-width: 200px;
411
+ overflow: hidden;
412
+ transition: max-height 0.3s ease;
413
+ }
414
+
415
+ .floating-toc-header {
416
+ padding: 8px 16px;
417
+ cursor: pointer;
418
+ user-select: none;
419
+ font-size: 14px;
420
+ font-weight: 500;
421
+ color: #1e293b;
422
+ display: flex;
423
+ align-items: center;
424
+ justify-content: space-between;
425
+ }
426
+
427
+ .floating-toc-header:hover {
428
+ background: rgba(0, 0, 0, 0.02);
429
+ }
430
+
431
+ .floating-toc-content {
432
+ max-height: 0;
433
+ overflow: hidden;
434
+ transition: max-height 0.3s ease;
435
+ }
436
+
437
+ .floating-toc-container:hover .floating-toc-content {
438
+ max-height: 70vh;
439
+ overflow-y: auto;
440
+ }
441
+
442
+ .floating-toc-content ul {
443
+ list-style: none;
444
+ padding: 8px 16px 16px;
445
+ margin: 0;
446
+ }
447
+
448
+ .floating-toc-content li {
449
+ margin: 0.1em 0;
450
+ }
451
+
452
+ .floating-toc-content a {
453
+ color: #0066cc;
454
+ text-decoration: none;
455
+ display: block;
456
+ padding: 0.2em 0.5em;
457
+ border-radius: 4px;
458
+ font-size: 13px;
459
+ transition: background 0.15s ease;
460
+ }
461
+
462
+ .floating-toc-content a:hover {
463
+ background: #e0e0e0;
464
+ color: #004499;
465
+ }
466
+
467
+ .floating-toc-content ul ul {
468
+ padding-left: 1.2em;
469
+ margin-top: 0;
470
+ margin-bottom: 0;
471
+ }
472
+
473
+ .floating-toc-content ul ul ul {
474
+ margin-top: 0;
475
+ margin-bottom: 0;
476
+ }
477
+
478
+ .floating-toc-content ul ul a {
479
+ font-size: 12px;
480
+ color: #555;
481
+ }
482
+
483
+ .floating-toc-content ul ul ul a {
484
+ font-size: 11px;
485
+ color: #666;
486
+ }
487
+
488
+ /* Smooth scrolling */
489
+ html {
490
+ scroll-behavior: smooth;
491
+ }
492
+
493
+ /* Code blocks */
494
+ code {
495
+ background: #f0f0f0;
496
+ padding: 0.2em 0.4em;
497
+ border-radius: 3px;
498
+ font-family: "Monaco", "Menlo", "Ubuntu Mono", monospace;
499
+ font-size: 0.9em;
500
+ margin: 0 0.1em;
501
+ }
502
+
503
+ pre {
504
+ background: #f5f5f5;
505
+ padding: 1rem;
506
+ overflow-x: auto;
507
+ border-radius: 4px;
508
+ margin: 1em 0;
509
+ }
510
+
511
+ pre code {
512
+ background: none;
513
+ padding: 0;
514
+ margin: 0;
515
+ }
516
+
517
+ /* Rouge syntax highlighting - GitHub theme, scoped to .highlight containers */
518
+ .highlight {
519
+ color: #24292e;
520
+ }
521
+
522
+ .highlight .c {
523
+ color: #6a737d;
524
+ font-style: italic;
525
+ } /* Comment */
526
+ .highlight .err {
527
+ color: #a61717;
528
+ background-color: #e3d2d2;
529
+ } /* Error */
530
+ .highlight .k {
531
+ color: #d73a49;
532
+ font-weight: bold;
533
+ } /* Keyword */
534
+ .highlight .l {
535
+ color: #032f62;
536
+ } /* Literal */
537
+ .highlight .n {
538
+ color: #24292e;
539
+ } /* Name */
540
+ .highlight .o {
541
+ color: #d73a49;
542
+ } /* Operator */
543
+ .highlight .p {
544
+ color: #24292e;
545
+ } /* Punctuation */
546
+ .highlight .cm {
547
+ color: #6a737d;
548
+ font-style: italic;
549
+ } /* Comment.Multiline */
550
+ .highlight .cp {
551
+ color: #6a737d;
552
+ font-weight: bold;
553
+ } /* Comment.Preproc */
554
+ .highlight .c1 {
555
+ color: #6a737d;
556
+ font-style: italic;
557
+ } /* Comment.Single */
558
+ .highlight .cs {
559
+ color: #6a737d;
560
+ font-weight: bold;
561
+ font-style: italic;
562
+ } /* Comment.Special */
563
+ .highlight .gd {
564
+ color: #24292e;
565
+ background-color: #ffeef0;
566
+ } /* Generic.Deleted */
567
+ .highlight .ge {
568
+ color: #24292e;
569
+ font-style: italic;
570
+ } /* Generic.Emph */
571
+ .highlight .gr {
572
+ color: #aa0000;
573
+ } /* Generic.Error */
574
+ .highlight .gh {
575
+ color: #999999;
576
+ font-weight: bold;
577
+ } /* Generic.Heading */
578
+ .highlight .gi {
579
+ color: #24292e;
580
+ background-color: #f0fff4;
581
+ } /* Generic.Inserted */
582
+ .highlight .go {
583
+ color: #888888;
584
+ } /* Generic.Output */
585
+ .highlight .gp {
586
+ color: #555555;
587
+ } /* Generic.Prompt */
588
+ .highlight .gs {
589
+ font-weight: bold;
590
+ } /* Generic.Strong */
591
+ .highlight .gu {
592
+ color: #aaaaaa;
593
+ } /* Generic.Subheading */
594
+ .highlight .gt {
595
+ color: #aa0000;
596
+ } /* Generic.Traceback */
597
+ .highlight .kc {
598
+ color: #d73a49;
599
+ font-weight: bold;
600
+ } /* Keyword.Constant */
601
+ .highlight .kd {
602
+ color: #d73a49;
603
+ font-weight: bold;
604
+ } /* Keyword.Declaration */
605
+ .highlight .kn {
606
+ color: #d73a49;
607
+ font-weight: bold;
608
+ } /* Keyword.Namespace */
609
+ .highlight .kp {
610
+ color: #d73a49;
611
+ font-weight: bold;
612
+ } /* Keyword.Pseudo */
613
+ .highlight .kr {
614
+ color: #d73a49;
615
+ font-weight: bold;
616
+ } /* Keyword.Reserved */
617
+ .highlight .kt {
618
+ color: #d73a49;
619
+ font-weight: bold;
620
+ } /* Keyword.Type */
621
+ .highlight .ld {
622
+ color: #032f62;
623
+ } /* Literal.Date */
624
+ .highlight .m {
625
+ color: #005cc5;
626
+ } /* Literal.Number */
627
+ .highlight .s {
628
+ color: #032f62;
629
+ } /* Literal.String */
630
+ .highlight .na {
631
+ color: #6f42c1;
632
+ } /* Name.Attribute */
633
+ .highlight .nb {
634
+ color: #005cc5;
635
+ } /* Name.Builtin */
636
+ .highlight .nc {
637
+ color: #6f42c1;
638
+ font-weight: bold;
639
+ } /* Name.Class */
640
+ .highlight .no {
641
+ color: #005cc5;
642
+ } /* Name.Constant */
643
+ .highlight .nd {
644
+ color: #6f42c1;
645
+ font-weight: bold;
646
+ } /* Name.Decorator */
647
+ .highlight .ni {
648
+ color: #800080;
649
+ } /* Name.Entity */
650
+ .highlight .ne {
651
+ color: #990000;
652
+ font-weight: bold;
653
+ } /* Name.Exception */
654
+ .highlight .nf {
655
+ color: #6f42c1;
656
+ } /* Name.Function */
657
+ .highlight .nl {
658
+ color: #990000;
659
+ } /* Name.Label */
660
+ .highlight .nn {
661
+ color: #555555;
662
+ } /* Name.Namespace */
663
+ .highlight .nx {
664
+ color: #6f42c1;
665
+ } /* Name.Other */
666
+ .highlight .py {
667
+ color: #990000;
668
+ } /* Name.Property */
669
+ .highlight .nt {
670
+ color: #22863a;
671
+ } /* Name.Tag */
672
+ .highlight .nv {
673
+ color: #e36209;
674
+ } /* Name.Variable */
675
+ .highlight .ow {
676
+ color: #d73a49;
677
+ font-weight: bold;
678
+ } /* Operator.Word */
679
+ .highlight .w {
680
+ color: #bbbbbb;
681
+ } /* Text.Whitespace */
682
+ .highlight .mf {
683
+ color: #005cc5;
684
+ } /* Literal.Number.Float */
685
+ .highlight .mh {
686
+ color: #005cc5;
687
+ } /* Literal.Number.Hex */
688
+ .highlight .mi {
689
+ color: #005cc5;
690
+ } /* Literal.Number.Integer */
691
+ .highlight .mo {
692
+ color: #005cc5;
693
+ } /* Literal.Number.Oct */
694
+ .highlight .sb {
695
+ color: #032f62;
696
+ } /* Literal.String.Backtick */
697
+ .highlight .sc {
698
+ color: #032f62;
699
+ } /* Literal.String.Char */
700
+ .highlight .sd {
701
+ color: #032f62;
702
+ } /* Literal.String.Doc */
703
+ .highlight .s2 {
704
+ color: #032f62;
705
+ } /* Literal.String.Double */
706
+ .highlight .se {
707
+ color: #032f62;
708
+ } /* Literal.String.Escape */
709
+ .highlight .sh {
710
+ color: #032f62;
711
+ } /* Literal.String.Heredoc */
712
+ .highlight .si {
713
+ color: #032f62;
714
+ } /* Literal.String.Interpol */
715
+ .highlight .sx {
716
+ color: #032f62;
717
+ } /* Literal.String.Other */
718
+ .highlight .sr {
719
+ color: #22863a;
720
+ } /* Literal.String.Regex */
721
+ .highlight .s1 {
722
+ color: #032f62;
723
+ } /* Literal.String.Single */
724
+ .highlight .ss {
725
+ color: #032f62;
726
+ } /* Literal.String.Symbol */
727
+ .highlight .bp {
728
+ color: #005cc5;
729
+ } /* Name.Builtin.Pseudo */
730
+ .highlight .vc {
731
+ color: #e36209;
732
+ } /* Name.Variable.Class */
733
+ .highlight .vg {
734
+ color: #e36209;
735
+ } /* Name.Variable.Global */
736
+ .highlight .vi {
737
+ color: #e36209;
738
+ } /* Name.Variable.Instance */
739
+ .highlight .il {
740
+ color: #005cc5;
741
+ } /* Literal.Number.Integer.Long */
742
+
743
+ /* Additional Rouge token classes that may be used */
744
+ .highlight .token {
745
+ color: #5670a0;
746
+ }
747
+ .highlight .token.list {
748
+ color: #546e9f;
749
+ }
750
+ .highlight .token.punctuation {
751
+ color: #3e8dad;
752
+ }
753
+ .highlight .token.list.punctuation {
754
+ color: #e05b78;
755
+ }
756
+ .highlight .token.content {
757
+ padding: 0;
758
+ }
759
+
760
+ /* Nested lists in page content */
761
+ ul ul,
762
+ ol ol,
763
+ ul ol,
764
+ ol ul {
765
+ padding-left: 1.5em;
766
+ margin-top: 0.25em;
767
+ }
768
+
769
+ /* Page footer */
770
+ .page-footer {
771
+ background: #f5f5f5;
772
+ border-top: 1px solid #ddd;
773
+ padding: 1.5rem;
774
+ margin-top: 3rem;
775
+ color: #666;
776
+ font-size: 0.9em;
777
+ }
778
+
779
+ .page-footer p {
780
+ margin: 0.5em 0;
781
+ }
782
+
783
+ .page-footer a {
784
+ color: #0066cc;
785
+ text-decoration: none;
786
+ }
787
+
788
+ .page-footer a:hover {
789
+ text-decoration: underline;
790
+ }
791
+
792
+ /* Mobile responsive */
793
+ @media (max-width: 768px) {
794
+ .hamburger-menu {
795
+ display: flex;
796
+ }
797
+
798
+ .main-toc,
799
+ .sidebar {
800
+ transform: translateX(-100%);
801
+ z-index: 175;
802
+ }
803
+
804
+ .main-toc.mobile-open,
805
+ .sidebar.mobile-open {
806
+ transform: translateX(0);
807
+ }
808
+
809
+ body {
810
+ margin: 2rem 1rem;
811
+ }
812
+
813
+ .floating-toc {
814
+ left: 0;
815
+ }
816
+ }
817
+
818
+ </style></head>
819
+
820
+ <body class="code-highlighted">
821
+ <div class="floating-toc" id="floating-toc">
822
+ <div class="floating-toc-container">
823
+ <div class="floating-toc-header">
824
+ <span>Table of Contents 🔻</span>
825
+ </div>
826
+ <div class="floating-toc-content" id="floating-toc-content">
827
+ <!-- Content will be populated by JavaScript -->
828
+ </div>
829
+ </div>
830
+ </div>
831
+
832
+ <button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
833
+ <div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
834
+
835
+ <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>
836
+
837
+ <h1 id="tables">
838
+ Tables
839
+ </h1>
840
+ <nav class="page-toc" id="page-toc-top"><ul><li><a href="#tables">Tables</a><ul><li><a href="#standard-pipe-tables">Standard Pipe&nbsp;Tables</a></li><li><a href="#relaxed-tables">Relaxed&nbsp;Tables</a></li><li><a href="#grid-tables-pandoc-style">Grid Tables&nbsp;(Pandoc-style)</a></li><li><a href="#headerless-tables">Headerless&nbsp;Tables</a><ul><li><a href="#row-header-columns">Row Header&nbsp;Columns</a></li></ul></li><li><a href="#inline-tables-from-csvtsv">Inline Tables from&nbsp;CSV/TSV</a><ul><li><a href="#fenced-csvtsv-tables">Fenced CSV/TSV&nbsp;Tables</a></li><li><a href="#alignment-rows-in-csvtsv-tables">Alignment Rows in CSV/TSV&nbsp;Tables</a></li><li><a href="#table-markers">&lt;!--TABLE--&gt;&nbsp;Markers</a></li></ul></li><li><a href="#column-spans">Column&nbsp;Spans</a><ul><li><a href="#consecutive-pipes">Consecutive&nbsp;Pipes</a></li><li><a href="#marker">&lt;&lt;&nbsp;Marker</a></li></ul></li><li><a href="#row-spans">Row&nbsp;Spans</a></li><li><a href="#combined-row-and-column-spans">Combined Row and Column&nbsp;Spans</a></li><li><a href="#individual-cell-alignment">Individual Cell&nbsp;Alignment</a></li><li><a href="#table-footers-tfoot">Table Footers&nbsp;(tfoot)</a></li><li><a href="#table-captions">Table&nbsp;Captions</a><ul><li><a href="#multimarkdown-style-captions">MultiMarkdown-Style&nbsp;Captions</a></li><li><a href="#pandoc-style-captions">Pandoc-Style&nbsp;Captions</a></li><li><a href="#pandoc-table-attributes-extension">Pandoc Table Attributes&nbsp;Extension</a></li><li><a href="#caption-position">Caption&nbsp;Position</a></li></ul></li><li><a href="#inline-attribute-lists-ials-for-tables">Inline Attribute Lists (IALs)&nbsp;for&nbsp;Tables</a><ul><li><a href="#ials-after-tables">IALs After&nbsp;Tables</a></li><li><a href="#ials-in-table-captions">IALs in Table&nbsp;Captions</a></li></ul></li><li><a href="#complete-example">Complete&nbsp;Example</a></li><li><a href="#see-also">See&nbsp;Also</a></li></ul></li></ul></nav>
841
+
842
+ <p>
843
+ Apex supports comprehensive table syntax including standard pipe tables, CSV/TSV tables, and advanced features like column/row spans, per-cell alignment, captions, and IAL attributes.
844
+ </p>
845
+
846
+ <h2 id="standard-pipe-tables">
847
+ Standard Pipe&nbsp;Tables
848
+ </h2>
849
+
850
+ <p>
851
+ Basic pipe table syntax with header row and separator:
852
+ </p>
853
+
854
+ <div class="highlight">
855
+ <pre><span></span>| Header 1 | Header 2 | Header 3 |
856
+ | -------- | <span class=\"emoji\">:------:</span> | -------: |
857
+ | Left | Center | Right |
858
+ | Data | Data | Data |
859
+ </pre>
860
+ </div>
861
+
862
+ <p>
863
+ Column alignment is specified in the separator row:
864
+ </p>
865
+
866
+ <ul>
867
+
868
+ <li>
869
+ <code>:---</code> or <code>---</code> - Left (default)
870
+ </li>
871
+
872
+ <li>
873
+ <code><span class=\"emoji\">:---:</span></code> - Center
874
+ </li>
875
+
876
+ <li>
877
+ <code>---:</code> - Right
878
+ </li>
879
+
880
+ </ul>
881
+
882
+ <h2 id="relaxed-tables">
883
+ Relaxed&nbsp;Tables
884
+ </h2>
885
+
886
+ <p>
887
+ In <strong>unified</strong> and <strong>kramdown</strong> modes, tables don’t require separator rows:
888
+ </p>
889
+
890
+ <div class="highlight">
891
+ <pre><span></span>one | two | three
892
+ 1 | 2 | 3
893
+ 4 | 5 | 6
894
+ </pre>
895
+ </div>
896
+
897
+ <p>
898
+ This automatically becomes a table. See <a href="Modes.html">Modes</a> for details.
899
+ </p>
900
+
901
+ <h2 id="grid-tables-pandoc-style">
902
+ Grid Tables&nbsp;(Pandoc-style)
903
+ </h2>
904
+
905
+ <p>
906
+ Pandoc <strong>grid tables</strong> use ASCII border rows instead of pipe separators. Enable with <code>--grid-tables</code> or disable explicitly with <code>--no-grid-tables</code> (disabled by default in unified mode).
907
+ </p>
908
+
909
+ <div class="highlight">
910
+ <pre><span></span>+---------------+---------------+
911
+ | Fruit | Price |
912
+ +:=============+==============:+
913
+ | Bananas | $1.34 |
914
+ | Oranges | $2.10 |
915
+ +---------------+---------------+
916
+ </pre>
917
+ </div>
918
+
919
+ <p>
920
+ <strong>Features supported:</strong>
921
+ </p>
922
+
923
+ <ul>
924
+
925
+ <li>
926
+ Header rows (<code>+===+</code> separator)
927
+ </li>
928
+
929
+ <li>
930
+ Column alignment from <code>:</code> markers in border rows (<code>+:===+</code>, <code>+===:+</code>, <code>+:===:+</code>)
931
+ </li>
932
+
933
+ <li>
934
+ Multiline cells (including lists and other block markdown in cells)
935
+ </li>
936
+
937
+ <li>
938
+ Full-row colspan (single cell spanning the table width)
939
+ </li>
940
+
941
+ <li>
942
+ Nested grids inside colspan cells
943
+ </li>
944
+
945
+ <li>
946
+ Partial in-row separators (<code>| Label +---+---+</code> patterns) with rowspan/colspan
947
+ <strong>Notes:</strong>
948
+ </li>
949
+
950
+ <li>
951
+ Grid tables require a blank line before and after the table block (same as pipe tables).
952
+ </li>
953
+
954
+ <li>
955
+ Lines inside fenced code blocks are never converted.
956
+ </li>
957
+
958
+ <li>
959
+ Complex layouts may differ slightly from Pandoc; see <a href="Limitations-and-Roadmap.html">Limitations and Roadmap</a>.
960
+ </li>
961
+
962
+ </ul>
963
+
964
+ <h2 id="headerless-tables">
965
+ Headerless&nbsp;Tables
966
+ </h2>
967
+
968
+ <p>
969
+ Apex supports tables that start with alignment rows (separator rows) without header rows. The alignment specified in the separator row is automatically applied to all columns:
970
+ </p>
971
+
972
+ <div class="highlight">
973
+ <pre><span></span>| | | |
974
+ | --- | --- | --- |
975
+ | a | b | c |
976
+ | 1 | 2 | 3 |
977
+ </pre>
978
+ </div>
979
+
980
+ <p>
981
+ Alignment specifiers work as usual:
982
+ </p>
983
+
984
+ <div class="highlight">
985
+ <pre><span></span>| | | |
986
+ |:---|<span class=\"emoji\">:---:</span>|---:|
987
+ | left | center | right |
988
+ </pre>
989
+ </div>
990
+
991
+ <p>
992
+ In this case, the first row (the alignment row) specifies the column alignment, and all subsequent data rows inherit that alignment. The empty header row that would normally be required is automatically handled.
993
+ </p>
994
+
995
+ <h3 id="row-header-columns">
996
+ Row Header&nbsp;Columns
997
+ </h3>
998
+
999
+ <p>
1000
+ You can mark the <strong>first column</strong> as a row-header column by starting the header row with an <strong>empty first cell</strong>:
1001
+ </p>
1002
+
1003
+ <div class="highlight">
1004
+ <pre><span></span>| | Header 1 | Header 2 |
1005
+ | Row 1 | data 1.1 | data 1.2 |
1006
+ | Row 2 | data 2.1 | data 2.2 |
1007
+ </pre>
1008
+ </div>
1009
+
1010
+ <p>
1011
+ When the first header cell is empty (for example, <code>| |</code> or <code>| |</code>), Apex will:
1012
+ </p>
1013
+
1014
+ <ul>
1015
+
1016
+ <li>
1017
+ Treat the rest of the header row as usual column headers.
1018
+ </li>
1019
+
1020
+ <li>
1021
+ Render the first cell of each body row as a <strong>row header</strong> using <code>&lt;th scope=&quot;row&quot;&gt;Row 1&lt;/th&gt;</code>, <code>&lt;th scope=&quot;row&quot;&gt;Row 2&lt;/th&gt;</code>, etc.
1022
+ Notes:
1023
+ </li>
1024
+
1025
+ <li>
1026
+ The row-header behavior only applies to the <strong>first column</strong> and only when the <strong>first header cell is empty</strong>.
1027
+ </li>
1028
+
1029
+ <li>
1030
+ Tables that start with <code>|data|data|</code> or <code>data|data</code> do <strong>not</strong> enable row headers.
1031
+ </li>
1032
+
1033
+ <li>
1034
+ This works together with all other table features (relaxed tables, headerless tables, colspans/rowspans, captions, etc.).
1035
+ </li>
1036
+
1037
+ </ul>
1038
+
1039
+ <h2 id="inline-tables-from-csvtsv">
1040
+ Inline Tables from&nbsp;CSV/TSV
1041
+ </h2>
1042
+
1043
+ <p>
1044
+ In addition to regular pipe tables, Apex can convert inline CSV/TSV text into tables.
1045
+ </p>
1046
+
1047
+ <h3 id="fenced-csvtsv-tables">
1048
+ Fenced CSV/TSV&nbsp;Tables
1049
+ </h3>
1050
+
1051
+ <p>
1052
+ Use a fenced code block with the info string <code>table</code>. The delimiter is detected automatically:
1053
+ </p>
1054
+
1055
+ <ul>
1056
+
1057
+ <li>
1058
+ If any non-blank line contains a <strong>tab</strong>, the block is treated as TSV.
1059
+ </li>
1060
+
1061
+ <li>
1062
+ Otherwise, if any non-blank line contains a <strong>comma</strong>, the block is treated as CSV.
1063
+ </li>
1064
+
1065
+ <li>
1066
+ If no tabs or commas are found, the block is left unchanged as a normal <code>table</code>-info code block (useful for showing literal CSV/TSV).
1067
+ </li>
1068
+
1069
+ </ul>
1070
+
1071
+ <div class="highlight">
1072
+ <pre><span></span><span class="sb">```table</span>
1073
+ <span class="s">header 1,header 2,header 3</span>
1074
+ <span class="s">data 1,data 2,data 3</span>
1075
+ <span class="s">,,data 2c</span>
1076
+ <span class="sb">```</span>
1077
+ </pre>
1078
+ </div>
1079
+
1080
+ <p>
1081
+ You can also use TSV with real tab characters:
1082
+ </p>
1083
+
1084
+ <div class="highlight">
1085
+ <pre><span></span><span class="sb">```table</span>
1086
+ <span class="s">col1 col2 col3</span>
1087
+ <span class="s">val1 val2 val3</span>
1088
+ <span class="sb">```</span>
1089
+ </pre>
1090
+ </div>
1091
+
1092
+ <h3 id="alignment-rows-in-csvtsv-tables">
1093
+ Alignment Rows in CSV/TSV&nbsp;Tables
1094
+ </h3>
1095
+
1096
+ <p>
1097
+ CSV/TSV inline tables can specify column alignment using a row of <strong>alignment keywords</strong>:
1098
+ </p>
1099
+
1100
+ <div class="highlight">
1101
+ <pre><span></span><span class="sb">```table</span>
1102
+ <span class="s">H1,H2,H3</span>
1103
+ <span class="s">left,center,right</span>
1104
+ <span class="s">a,b,c</span>
1105
+ <span class="sb">```</span>
1106
+ </pre>
1107
+ </div>
1108
+
1109
+ <p>
1110
+ The alignment row is not rendered as data; it is converted to the equivalent Markdown alignment row:
1111
+ </p>
1112
+
1113
+ <ul>
1114
+
1115
+ <li>
1116
+ <code>left</code> → <code>:---</code>
1117
+ </li>
1118
+
1119
+ <li>
1120
+ <code>center</code> → <code><span class=\"emoji\">:---:</span></code>
1121
+ </li>
1122
+
1123
+ <li>
1124
+ <code>right</code> → <code>---:</code>
1125
+ </li>
1126
+
1127
+ <li>
1128
+ <code>auto</code> → <code>---</code>
1129
+ If the first row contains only alignment keywords, it becomes a <strong>headless table</strong>: the alignment row is emitted first and all following rows become body rows. If there is <strong>no alignment row at all</strong>, Apex emits a default <code>---</code> separator row so that relaxed/headless table handling still works as expected.
1130
+ </li>
1131
+
1132
+ </ul>
1133
+
1134
+ <h3 id="table-markers">
1135
+ <code>&lt;!--TABLE--&gt;</code>&nbsp;Markers
1136
+ </h3>
1137
+
1138
+ <p>
1139
+ You can also start an inline CSV/TSV table with an HTML comment:
1140
+ </p>
1141
+
1142
+ <div class="highlight">
1143
+ <pre><span></span>&lt;!--TABLE--&gt;
1144
+ header 1,header 2,header 3
1145
+ data 1,data 2,data 3
1146
+ ,,data 2c
1147
+ </pre>
1148
+ </div>
1149
+
1150
+ <table>
1151
+
1152
+ <thead>
1153
+
1154
+ <tr>
1155
+
1156
+ <th>
1157
+ <code>| </code> consumes the following <strong>contiguous non-blank lines</strong> as table data (stopping at the first blank line)
1158
+ </th>
1159
+
1160
+ <th>
1161
+ applies the same delimiter detection and optional alignment-row handling
1162
+ </th>
1163
+
1164
+ <th>
1165
+ and converts the block into a table. If no tabs or commas are found
1166
+ </th>
1167
+
1168
+ <th>
1169
+ the comment and lines are left unchanged.
1170
+ </th>
1171
+
1172
+ </tr>
1173
+
1174
+ </thead>
1175
+
1176
+ </table>
1177
+
1178
+ <h2 id="column-spans">
1179
+ Column&nbsp;Spans
1180
+ </h2>
1181
+
1182
+ <p>
1183
+ Column spans allow a cell to span multiple columns. There are two ways to create column spans:
1184
+ </p>
1185
+
1186
+ <h3 id="consecutive-pipes">
1187
+ Consecutive&nbsp;Pipes
1188
+ </h3>
1189
+
1190
+ <p>
1191
+ Use consecutive pipes with no content between them to create column spans. Place the consecutive pipes after the cell content, and they will cause that cell to span the specified number of additional columns:
1192
+ </p>
1193
+
1194
+ <div class="highlight">
1195
+ <pre><span></span>| | Table | Has | Colspans |
1196
+ | ------ | ------ | --- | -------------- |
1197
+ | row 1 ||| colspan |
1198
+ | row 2 | span 2 || &amp;larr; colspan |
1199
+ </pre>
1200
+ </div>
1201
+
1202
+ <ul>
1203
+
1204
+ <li>
1205
+ <code>| &lt;&lt; |</code> (2 consecutive pipes) causes the previous cell to span 2 columns total (its own column plus 1 additional)
1206
+ </li>
1207
+
1208
+ <li>
1209
+ <code>| &lt;&lt; | &lt;&lt; |</code> (3 consecutive pipes) causes the previous cell to span 3 columns total (its own column plus 2 additional)
1210
+ </li>
1211
+
1212
+ <li>
1213
+ <code>| &lt;&lt; | &lt;&lt; | &lt;&lt; |</code> (4 consecutive pipes) causes the previous cell to span 4 columns total (its own column plus 3 additional)
1214
+ In the first row above, <code>| &lt;&lt; | &lt;&lt; |</code> after “colspan” causes “colspan” to span across 3 columns total. In the second row, <code>| &lt;&lt; |</code> after “cell” causes “cell” to span across 2 columns total (its own column plus the next column).
1215
+ </li>
1216
+
1217
+ </ul>
1218
+
1219
+ <h3 `| ` consumes the following **contiguous non-blank lines** as table data (stopping at the first blank line) id="marker">
1220
+ <code>&lt;&lt;</code>&nbsp;Marker
1221
+ </h3>
1222
+
1223
+ <p>
1224
+ You can also use the <code>&lt;&lt;</code> marker in a cell to force a colspan without using consecutive pipes. This allows whitespace and table alignment in the Markdown source:
1225
+ </p>
1226
+
1227
+ <div class="highlight">
1228
+ <pre><span></span>| A | B | C |
1229
+ | --- | --- | --- |
1230
+ | D | &lt;&lt; | &lt;&lt; |
1231
+ </pre>
1232
+ </div>
1233
+
1234
+ <p>
1235
+ The <code>&lt;&lt;</code> marker creates a column span just like consecutive pipes, but allows you to maintain proper table alignment and add whitespace for readability in your source Markdown. Each <code>&lt;&lt;</code> marker in a cell indicates that cell is part of a colspan from the previous cell. In the example above, <code>D</code> spans 3 columns total (its own column plus the 2 columns containing <code>&lt;&lt;</code> markers).
1236
+ To include a <strong>literal</strong> <code>&lt;&lt;</code> in a table cell (without creating a colspan), escape the first <code>&lt;</code> with a backslash: <code>\&lt;&lt;</code>. The backslash-plus-less-than is treated as an escaped <code>&lt;</code>, so <code>\&lt;&lt;</code> is rendered as the two characters <code>&lt;&lt;</code> and does not trigger colspan behavior. For text plus literal <code>&lt;&lt;</code> (e.g. “raw &lt;&lt;”), use <code>raw \&lt;&lt;</code> so the cell is not treated as a colspan and the column is preserved.
1237
+ <strong>Note:</strong> Blank cells containing whitespace (like <code>| |</code> or <code>| |</code>) are rendered as empty cells, <strong>not</strong> as column spans. Only cells with no whitespace and no content between consecutive pipes (like <code>| &lt;&lt; |</code> or <code>| &lt;&lt; | &lt;&lt; |</code>) create column spans.
1238
+ </p>
1239
+
1240
+ <h2 applies the same delimiter detection and optional alignment-row handling id="row-spans">
1241
+ Row&nbsp;Spans
1242
+ </h2>
1243
+
1244
+ <p>
1245
+ Row spans allow a cell to span multiple rows. Use the <code>^^</code> marker to create a row span:
1246
+ </p>
1247
+
1248
+ <div class="highlight">
1249
+ <pre><span></span>| A | B |
1250
+ | --- | --- |
1251
+ | C | D |
1252
+ | ^^ | E |
1253
+ </pre>
1254
+ </div>
1255
+
1256
+ <p>
1257
+ The <code>^^</code> marker creates a row span on the cell above. In this example, the cell containing “C” spans two rows.
1258
+ Consecutive <code>^^</code> markers stack to create larger row spans:
1259
+ </p>
1260
+
1261
+ <div class="highlight">
1262
+ <pre><span></span>| A | B | C |
1263
+ | --- | --- | --- |
1264
+ | X | Y | Z |
1265
+ | ^^ | W | V |
1266
+ | ^^ | U | T |
1267
+ </pre>
1268
+ </div>
1269
+
1270
+ <p>
1271
+ Here, the cell “X” spans three rows total.
1272
+ </p>
1273
+
1274
+ <h2 and converts the block into a table. If no tabs or commas are found id="combined-row-and-column-spans">
1275
+ Combined Row and Column&nbsp;Spans
1276
+ </h2>
1277
+
1278
+ <p>
1279
+ You can mix rowspans and colspans in the same table to create more complex layouts:
1280
+ </p>
1281
+
1282
+ <div class="highlight">
1283
+ <pre><span></span>| Department | Employee | Q1-Q2 Average | Q3 | Q4 | Overall |
1284
+ | ----------- | -------- | ------------- | ------ | --- | ------- |
1285
+ | Engineering | Alice | 93.5 | 94 | 96 | 94.25 |
1286
+ | ^^ | Bob | 89.0 | 87 | 91 | 89.00 |
1287
+ | Marketing | Charlie | 92.0 | Absent | | 92.00 |
1288
+ | Sales | Diana | 87.5 | 88 | 90 | 88.50 |
1289
+ | ^^ | Eve | 93.0 | 95 | 93 | 93.50 |
1290
+ </pre>
1291
+ </div>
1292
+
1293
+ <p>
1294
+ Here <code>^^</code> creates rowspans for the <code>Department</code> column. The example demonstrates how rowspans work with regular data rows.
1295
+ </p>
1296
+
1297
+ <h2 the comment and lines are left unchanged. id="individual-cell-alignment">
1298
+ Individual Cell&nbsp;Alignment
1299
+ </h2>
1300
+
1301
+ <p>
1302
+ Table cells can be aligned individually using colons, similar to Jekyll Spaceship. This allows you to override the default column alignment on a per-cell basis:
1303
+ </p>
1304
+
1305
+ <div class="highlight">
1306
+ <pre><span></span>| Header | Header | Header |
1307
+ | --- | --- | --- |
1308
+ | :Left | Center: | <span class=\"emoji\">:Center:</span> |
1309
+ | Right: | Normal | :Left |
1310
+ </pre>
1311
+ </div>
1312
+
1313
+ <p>
1314
+ Alignment syntax:
1315
+ </p>
1316
+
1317
+ <ul>
1318
+
1319
+ <li>
1320
+ <code>:Text</code> or <code>: Text</code> - Left align (leading colon)
1321
+ </li>
1322
+
1323
+ <li>
1324
+ <code>Text:</code> or <code>Text :</code> - Right align (trailing colon)
1325
+ </li>
1326
+
1327
+ <li>
1328
+ <code><span class=\"emoji\">:Text:</span></code> or <code>: Text :</code> - Center align (both colons)
1329
+ The colons are removed from the output, and the alignment is applied via CSS <code>text-align</code> styles. Escaped colons (<code>\:</code>) are not treated as alignment markers.
1330
+ Cell-level alignment overrides the column-level alignment specified in the separator row.
1331
+ </li>
1332
+
1333
+ </ul>
1334
+
1335
+ <h2 id="table-footers-tfoot">
1336
+ Table Footers&nbsp;(tfoot)
1337
+ </h2>
1338
+
1339
+ <p>
1340
+ You can create table footers using a row where every cell contains only <code>===</code> (three or more equals, with optional extra <code>=</code> and whitespace). This row acts as a <strong>footer divider</strong>:
1341
+ </p>
1342
+
1343
+ <div class="highlight">
1344
+ <pre><span></span>| h1 | h2 | h3 |
1345
+ | --- | <span class=\"emoji\">:---:</span> | --- |
1346
+ | d1 | d2 | d3 |
1347
+ | d1 | d2 | d3 |
1348
+ | === | === | === |
1349
+ | d-4 | d-5 | d-6 |
1350
+ </pre>
1351
+ </div>
1352
+
1353
+ <p>
1354
+ The <code>===</code> row is treated as a footer divider and is removed from the output. All following rows are rendered inside <code>&lt;tfoot&gt;</code>.
1355
+ The footer separator must appear after all body rows. Once the <code>===</code> row is encountered, all subsequent rows until the end of the table (or a blank line) are treated as footer rows.
1356
+ </p>
1357
+
1358
+ <h2 id="table-captions">
1359
+ Table&nbsp;Captions
1360
+ </h2>
1361
+
1362
+ <p>
1363
+ Tables can have captions that appear before or after the table. Apex supports multiple caption formats:
1364
+ </p>
1365
+
1366
+ <h3 id="multimarkdown-style-captions">
1367
+ MultiMarkdown-Style&nbsp;Captions
1368
+ </h3>
1369
+
1370
+ <p>
1371
+ Captions in square brackets:
1372
+ </p>
1373
+
1374
+ <div class="highlight">
1375
+ <pre><span></span>[Table Caption]
1376
+
1377
+ | A | B |
1378
+ | --- | --- |
1379
+ | C | D |
1380
+ </pre>
1381
+ </div>
1382
+
1383
+ <p>
1384
+ Captions can appear <strong>before or after</strong> a table. They must be contiguous with the table (no other content between them), but a blank line is allowed:
1385
+ </p>
1386
+
1387
+ <div class="highlight">
1388
+ <pre><span></span>| A | B |
1389
+ | --- | --- |
1390
+ | C | D |
1391
+
1392
+ [Caption after table]
1393
+ </pre>
1394
+ </div>
1395
+
1396
+ <h3 id="pandoc-style-captions">
1397
+ Pandoc-Style&nbsp;Captions
1398
+ </h3>
1399
+
1400
+ <p>
1401
+ Pandoc-style <code> [Caption</code> lines are also supported:]
1402
+ </p>
1403
+
1404
+ <div class="highlight">
1405
+ <pre><span></span>| A | B |
1406
+ | --- | --- |
1407
+ | C | D |
1408
+
1409
+ Table: Caption after table
1410
+ </pre>
1411
+ </div>
1412
+
1413
+ <p>
1414
+ Pandoc-style <code> [Caption</code> lines are normalized to <code>[Caption]</code> before parsing, so they work with the same caption rendering as MultiMarkdown captions.]
1415
+ </p>
1416
+
1417
+ <h3 id="pandoc-table-attributes-extension">
1418
+ Pandoc Table Attributes&nbsp;Extension
1419
+ </h3>
1420
+
1421
+ <p>
1422
+ Apex supports Pandoc’s <code>table_attributes</code> extension using the <code>: Caption</code> syntax:
1423
+ </p>
1424
+
1425
+ <div class="highlight">
1426
+ <pre><span></span>| Key | Value |
1427
+ | --- | <span class=\"emoji\">:---:</span> |
1428
+ | one | 1 |
1429
+ | two | 2 |
1430
+
1431
+ : Key value table {#table-id .testing key=&quot;value&quot;}
1432
+ </pre>
1433
+ </div>
1434
+
1435
+ <p>
1436
+ The <code>: Caption</code> format (with optional IAL attributes) is recognized when it appears immediately before or after a table. IAL attributes in the caption are extracted and applied to the table element itself.
1437
+ <strong>Note:</strong> The <code>: Caption</code> syntax only works when adjacent to a table to avoid conflicts with definition list syntax. If a line starting with <code>:</code> is not next to a table, it will be processed as a definition list item.
1438
+ </p>
1439
+
1440
+ <h3 id="caption-position">
1441
+ Caption&nbsp;Position
1442
+ </h3>
1443
+
1444
+ <p>
1445
+ By default, captions appear <strong>below</strong> the table. Use the <code>--captions above</code> option to place captions above the table instead. The <code>--captions below</code> option (or default) places them below. See <a href="Command-Line-Options.html">Command Line Options</a> for details.
1446
+ </p>
1447
+
1448
+ <h2 id="inline-attribute-lists-ials-for-tables">
1449
+ Inline Attribute Lists (IALs)&nbsp;for&nbsp;Tables
1450
+ </h2>
1451
+
1452
+ <p>
1453
+ Tables support Inline Attribute Lists (IALs) for adding HTML attributes like IDs, classes, and custom key-value pairs. See <a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a> for complete IAL syntax documentation.
1454
+ </p>
1455
+
1456
+ <h3 id="ials-after-tables">
1457
+ IALs After&nbsp;Tables
1458
+ </h3>
1459
+
1460
+ <p>
1461
+ Tables can have IALs applied on a separate line after the table:
1462
+ </p>
1463
+
1464
+ <div class="highlight">
1465
+ <pre><span></span>| Key | Value |
1466
+ | --- | <span class=\"emoji\">:---:</span> |
1467
+ | one | 1 |
1468
+ | two | 2 |
1469
+
1470
+ {: <span class="ni">#data</span>-table .striped .bordered}
1471
+ </pre>
1472
+ </div>
1473
+
1474
+ <p>
1475
+ This applies the attributes to the <code>&lt;table&gt;</code> element:
1476
+ </p>
1477
+
1478
+ <div class="highlight">
1479
+ <pre><span></span><span class="p">&lt;</span><span class="nt">table</span> <span class="na">id</span><span class="o">=</span><span class="s">&quot;data-table&quot;</span> <span class="na">class</span><span class="o">=</span><span class="s">&quot;striped bordered&quot;</span><span class="p">&gt;</span>
1480
+ <span class="cm">&lt;!-- table content --&gt;</span>
1481
+ <span class="p">&lt;/</span><span class="nt">table</span><span class="p">&gt;</span>
1482
+ </pre>
1483
+ </div>
1484
+
1485
+ <p>
1486
+ Apex supports both Kramdown-style IALs (<code>{: #id .class}</code>) and Pandoc-style IALs without the colon (<code>{#id .class}</code>):
1487
+ </p>
1488
+
1489
+ <div class="highlight">
1490
+ <pre><span></span>| Key | Value |
1491
+ | --- | <span class=\"emoji\">:---:</span> |
1492
+ | one | 1 |
1493
+ | two | 2 |
1494
+
1495
+ {#table-id .my-class key=&quot;value&quot;}
1496
+ </pre>
1497
+ </div>
1498
+
1499
+ <h3 id="ials-in-table-captions">
1500
+ IALs in Table&nbsp;Captions
1501
+ </h3>
1502
+
1503
+ <p>
1504
+ When using Pandoc-style captions with the <code>: Caption</code> syntax, IAL attributes in the caption are extracted and applied to the table:
1505
+ </p>
1506
+
1507
+ <div class="highlight">
1508
+ <pre><span></span>| Key | Value |
1509
+ | --- | <span class=\"emoji\">:---:</span> |
1510
+ | one | 1 |
1511
+ | two | 2 |
1512
+
1513
+ : Key value table {#table-id .testing key=&quot;value&quot;}
1514
+ </pre>
1515
+ </div>
1516
+
1517
+ <p>
1518
+ This is equivalent to:
1519
+ </p>
1520
+
1521
+ <div class="highlight">
1522
+ <pre><span></span>| Key | Value |
1523
+ | --- | <span class=\"emoji\">:---:</span> |
1524
+ | one | 1 |
1525
+ | two | 2 |
1526
+
1527
+ {: <span class="ni">#table</span>-id .testing key=&quot;value&quot;}
1528
+ </pre>
1529
+ </div>
1530
+
1531
+ <p>
1532
+ Both Kramdown-style IALs (<code>{: #id .class}</code>) and Pandoc-style IALs without the colon (<code>{#id .class}</code>) are supported in table captions.
1533
+ </p>
1534
+
1535
+ <h2 id="complete-example">
1536
+ Complete&nbsp;Example
1537
+ </h2>
1538
+
1539
+ <p>
1540
+ Here’s a comprehensive example combining multiple advanced features:
1541
+ </p>
1542
+
1543
+ <div class="highlight">
1544
+ <pre><span></span>[Employee Performance Q4 2025]
1545
+ | Department | Employee | Q1-Q2 Average | Q3 | Q4 | Overall |
1546
+ | ----------- | -------- | ------------- | ------ | --- | ------- |
1547
+ | Engineering | Alice | 93.5 | 94 | 96 | 94.25 |
1548
+ | ^^ | Bob | 89.0 | 87 | 91 | 89.00 |
1549
+ | Marketing | Charlie | 92.0 | Absent ||| 92.00 |
1550
+ | Sales | Diana | 87.5 | 88 | 90 | 88.50 |
1551
+ | ^^ | Eve | 93.0 | 95 | 93 | 93.50 |
1552
+ | === | === | === | === | === | === |
1553
+ | Total ||| <span class=\"emoji\">:Center:</span> ||| 92.05 |
1554
+
1555
+ {: .performance-table <span class="ni">#q4</span>-results .striped}
1556
+ </pre>
1557
+ </div>
1558
+
1559
+ <p>
1560
+ This example demonstrates:
1561
+ </p>
1562
+
1563
+ <ul>
1564
+
1565
+ <li>
1566
+ <strong>Caption</strong>: <code>[Employee Performance Q4 2025]</code> before the table
1567
+ </li>
1568
+
1569
+ <li>
1570
+ <strong>Row spans</strong>: <code>^^</code> markers create rowspans for the Department column
1571
+ </li>
1572
+
1573
+ <li>
1574
+ <strong>Column spans</strong>: Consecutive pipes (<code>| &lt;&lt; | &lt;&lt; |</code>) in the “Absent” row create a colspan spanning the Q4 column
1575
+ </li>
1576
+
1577
+ <li>
1578
+ <strong>Per-cell alignment</strong>: <code><span class=\"emoji\">:Center:</span></code> in the footer row overrides column alignment
1579
+ </li>
1580
+
1581
+ <li>
1582
+ <strong>Table footer</strong>: <code>===</code> row creates a footer section
1583
+ </li>
1584
+
1585
+ <li>
1586
+ <strong>IAL attributes</strong>: <code>{: .performance-table #q4-results .striped}</code> applies classes and ID to the table
1587
+ </li>
1588
+
1589
+ </ul>
1590
+
1591
+ <h2 id="see-also">
1592
+ See&nbsp;Also
1593
+ </h2>
1594
+
1595
+ <ul>
1596
+
1597
+ <li>
1598
+ <a href="Syntax.html">Syntax</a> - General syntax documentation
1599
+ </li>
1600
+
1601
+ <li>
1602
+ <a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a> - Complete IAL syntax reference
1603
+ </li>
1604
+
1605
+ <li>
1606
+ <a href="Command-Line-Options.html">Command Line Options</a> - Table-related command-line options
1607
+ </li>
1608
+
1609
+ <li>
1610
+ <a href="Modes.html">Modes</a> - Table features available in different modes
1611
+ </li>
1612
+
1613
+ </ul>
1614
+
1615
+ <script>
1616
+ // Hamburger menu functionality
1617
+ (function() {
1618
+ function initHamburgerMenu() {
1619
+ var hamburger = document.getElementById('hamburger-menu');
1620
+ var sidebar = document.querySelector('.main-toc, .sidebar');
1621
+ var overlay = document.getElementById('mobile-menu-overlay');
1622
+
1623
+ if (!hamburger || !sidebar) return;
1624
+
1625
+ function toggleMenu() {
1626
+ var isOpen = sidebar.classList.contains('mobile-open');
1627
+ if (isOpen) {
1628
+ sidebar.classList.remove('mobile-open');
1629
+ hamburger.classList.remove('active');
1630
+ if (overlay) overlay.classList.remove('active');
1631
+ } else {
1632
+ sidebar.classList.add('mobile-open');
1633
+ hamburger.classList.add('active');
1634
+ if (overlay) overlay.classList.add('active');
1635
+ }
1636
+ }
1637
+
1638
+ hamburger.addEventListener('click', function(e) {
1639
+ e.stopPropagation();
1640
+ toggleMenu();
1641
+ });
1642
+
1643
+ if (overlay) {
1644
+ overlay.addEventListener('click', function() {
1645
+ toggleMenu();
1646
+ });
1647
+ }
1648
+
1649
+ // Close menu when clicking on a sidebar link (mobile only)
1650
+ if (window.innerWidth <= 768) {
1651
+ var sidebarLinks = sidebar.querySelectorAll('a');
1652
+ sidebarLinks.forEach(function(link) {
1653
+ link.addEventListener('click', function() {
1654
+ setTimeout(function() {
1655
+ sidebar.classList.remove('mobile-open');
1656
+ hamburger.classList.remove('active');
1657
+ if (overlay) overlay.classList.remove('active');
1658
+ }, 100);
1659
+ });
1660
+ });
1661
+ }
1662
+
1663
+ // Close menu on window resize if going to desktop
1664
+ window.addEventListener('resize', function() {
1665
+ if (window.innerWidth > 768) {
1666
+ sidebar.classList.remove('mobile-open');
1667
+ hamburger.classList.remove('active');
1668
+ if (overlay) overlay.classList.remove('active');
1669
+ }
1670
+ });
1671
+ }
1672
+
1673
+ // Initialize when DOM is ready
1674
+ if (document.readyState === 'loading') {
1675
+ document.addEventListener('DOMContentLoaded', initHamburgerMenu);
1676
+ } else {
1677
+ initHamburgerMenu();
1678
+ }
1679
+ })();
1680
+
1681
+ </script>
1682
+ <script>
1683
+ (function() {
1684
+ // Clone the page TOC for floating TOC
1685
+ function initFloatingTOC() {
1686
+ var pageTOC = document.getElementById('page-toc-top');
1687
+ var floatingTOCContent = document.getElementById('floating-toc-content');
1688
+ var floatingTOC = document.getElementById('floating-toc');
1689
+
1690
+ if (!pageTOC || !floatingTOCContent || !floatingTOC) return;
1691
+
1692
+ // Clone the TOC structure
1693
+ var tocClone = pageTOC.cloneNode(true);
1694
+ tocClone.id = 'floating-toc-clone';
1695
+ floatingTOCContent.appendChild(tocClone);
1696
+
1697
+ // Update all links to use smooth scrolling
1698
+ var allTOCLinks = document.querySelectorAll('.page-toc a, .floating-toc-content a');
1699
+ allTOCLinks.forEach(function(link) {
1700
+ link.addEventListener('click', function(e) {
1701
+ var href = this.getAttribute('href');
1702
+ if (href && href.startsWith('#')) {
1703
+ e.preventDefault();
1704
+ var targetId = href.substring(1);
1705
+ var targetElement = document.getElementById(targetId);
1706
+ if (targetElement) {
1707
+ var offset = 20; // Offset from top
1708
+
1709
+ // Function to calculate absolute position from document top
1710
+ function getAbsoluteTop(element) {
1711
+ var top = 0;
1712
+ while (element) {
1713
+ top += element.offsetTop;
1714
+ element = element.offsetParent;
1715
+ }
1716
+ return top;
1717
+ }
1718
+
1719
+ var absoluteTop = getAbsoluteTop(targetElement);
1720
+ var scrollTop = window.pageYOffset || document.documentElement.scrollTop;
1721
+ var offsetPosition = absoluteTop - offset;
1722
+
1723
+ // Only scroll if we're not already at the target position
1724
+ if (Math.abs(scrollTop - offsetPosition) > 10) {
1725
+ window.scrollTo({
1726
+ top: Math.max(0, offsetPosition),
1727
+ behavior: 'smooth'
1728
+ });
1729
+ }
1730
+
1731
+ // Update URL hash without triggering scroll
1732
+ if (history.pushState) {
1733
+ history.pushState(null, null, href);
1734
+ }
1735
+ }
1736
+ }
1737
+ });
1738
+ });
1739
+
1740
+ // Handle scroll to show/hide floating TOC
1741
+ var tocTop = pageTOC.getBoundingClientRect().top + window.pageYOffset;
1742
+ var tocBottom = tocTop + pageTOC.offsetHeight;
1743
+
1744
+ function updateFloatingTOC() {
1745
+ var scrollY = window.pageYOffset || document.documentElement.scrollTop;
1746
+
1747
+ if (scrollY > tocBottom) {
1748
+ floatingTOC.classList.add('visible');
1749
+ } else {
1750
+ floatingTOC.classList.remove('visible');
1751
+ }
1752
+ }
1753
+
1754
+ // Throttle scroll events
1755
+ var ticking = false;
1756
+ window.addEventListener('scroll', function() {
1757
+ if (!ticking) {
1758
+ window.requestAnimationFrame(function() {
1759
+ updateFloatingTOC();
1760
+ ticking = false;
1761
+ });
1762
+ ticking = true;
1763
+ }
1764
+ });
1765
+
1766
+ // Initial check
1767
+ updateFloatingTOC();
1768
+ }
1769
+
1770
+ // Initialize when DOM is ready
1771
+ if (document.readyState === 'loading') {
1772
+ document.addEventListener('DOMContentLoaded', initFloatingTOC);
1773
+ } else {
1774
+ initFloatingTOC();
1775
+ }
1776
+ })();
1777
+ </script>
1778
+ <footer class="page-footer"><p>Copyright 2025 Brett Terpstra, All Rights Reserved | MIT License</p></footer></body>
1779
+
1780
+ </html>
1781
+