apex-ruby 1.0.18 → 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.
- checksums.yaml +4 -4
- data/README.md +17 -3
- data/ext/apex_ext/apex_ext.c +260 -91
- data/ext/apex_ext/apex_src/CHANGELOG.md +440 -0
- data/ext/apex_ext/apex_src/CMakeLists.txt +15 -1
- data/ext/apex_ext/apex_src/Formula/apex.rb +7 -2
- data/ext/apex_ext/apex_src/Package.swift +15 -4
- data/ext/apex_ext/apex_src/README.md +94 -35
- data/ext/apex_ext/apex_src/VERSION +1 -1
- data/ext/apex_ext/apex_src/apex-debug.log +4 -0
- data/ext/apex_ext/apex_src/apex.code-workspace +38 -0
- data/ext/apex_ext/apex_src/apex.taskpaper +12 -0
- data/ext/apex_ext/apex_src/apex_deflist_debug.log +25 -0
- data/ext/apex_ext/apex_src/buildnotes.md +1435 -0
- data/ext/apex_ext/apex_src/cli/main.c +262 -33
- data/ext/apex_ext/apex_src/debug.log +7 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_EXAMPLES.md +274 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_IMPLEMENTATION_PLAN.md +749 -0
- data/ext/apex_ext/apex_src/docs/CITATIONS_PLAN.md +744 -0
- data/ext/apex_ext/apex_src/docs/INDEX_IMPLEMENTATION_ANALYSIS.md +382 -0
- data/ext/apex_ext/apex_src/docs/plans/2025-02-27-man-page-output-implementation.md +351 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-12-toc-output-format.md +745 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-18-bear-image-attributes.md +829 -0
- data/ext/apex_ext/apex_src/docs/superpowers/plans/2026-07-19-apex-node-npm.md +1148 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-12-toc-output-format-design.md +161 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-18-bear-image-attributes-design.md +184 -0
- data/ext/apex_ext/apex_src/docs/superpowers/specs/2026-07-19-apex-node-npm-design.md +211 -0
- data/ext/apex_ext/apex_src/documentation/app-settings-table.md +67 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Citations.md +340 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Credits.md +11 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Header-IDs.md +234 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Inline-Attribute-Lists.md +516 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Metadata-Transforms.md +461 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Modes.md +193 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Multi-File-Documents.md +201 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Plugins.md +678 -0
- data/ext/apex_ext/apex_src/documentation/app-transformed/Syntax.md +1367 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex Command Line Options.cheatsheet.txt +6 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/C-API.html +774 -300
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Callouts.html +1194 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Citations.html +416 -216
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Command-Line-Options.html +3544 -1094
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Configuration.html +371 -97
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Credits.html +153 -23
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Examples.html +358 -124
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Filters.html +1656 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Generating-Man-Pages.html +1226 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Getting-Started.html +201 -56
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Header-IDs.html +279 -109
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Home.html +200 -53
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Indices.html +2327 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Inline-Attribute-Lists.html +690 -271
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Installation.html +201 -55
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Limitations-and-Roadmap.html +238 -68
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Metadata-Transforms.html +421 -221
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Modes.html +340 -78
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-File-Documents.html +251 -86
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Multi-Format-Images.html +1362 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Pandoc-Integration.html +277 -90
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Plugins.html +673 -346
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Quarto-Mode.html +1405 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Rendering-Markdown-In-Terminal.html +1902 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Syntax.html +1939 -1698
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Tables.html +1781 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Troubleshooting.html +315 -140
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html +307 -113
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Using-Apex-with-Jekyll.html +1132 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Writing-Tests.html +1754 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Xcode-Integration.html +872 -376
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/docSet.dsidx +0 -0
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/optimizedIndex.dsidx +0 -0
- data/ext/apex_ext/apex_src/documentation/html/apex-app-docs.html +8746 -0
- data/ext/apex_ext/apex_src/documentation/shared_styles.css +20 -15
- data/ext/apex_ext/apex_src/documentation/transform_for_app.md +55 -0
- data/ext/apex_ext/apex_src/escaping-repro.md +103 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/Info.plist +8 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/QuickLook/Preview.png +0 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown to RTF.workflow/Contents/document.wflow +547 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/Markdown-to-RTF.workflow.zip +0 -0
- data/ext/apex_ext/apex_src/examples/quick-actions/README.md +33 -0
- data/ext/apex_ext/apex_src/include/apex/apex.h +92 -6
- data/ext/apex_ext/apex_src/include/apex/ast_rtf.h +23 -0
- data/ext/apex_ext/apex_src/include/apex/ast_terminal.h +6 -0
- data/ext/apex_ext/apex_src/include/apex/module.modulemap +5 -0
- data/ext/apex_ext/apex_src/include/apex/plugins.h +105 -0
- data/ext/apex_ext/apex_src/include/apexc.h +1 -0
- data/ext/apex_ext/apex_src/man/apex.1 +82 -78
- data/ext/apex_ext/apex_src/man/apex.1.md +81 -4
- data/ext/apex_ext/apex_src/objc/Apex.swift +73 -0
- data/ext/apex_ext/apex_src/objc/ApexPlugins.swift +79 -0
- data/ext/apex_ext/apex_src/objc/NSString+Apex.h +83 -5
- data/ext/apex_ext/apex_src/objc/NSString+Apex.m +244 -1
- data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.h +76 -0
- data/ext/apex_ext/apex_src/objc/NSString+ApexPlugins.m +169 -0
- data/ext/apex_ext/apex_src/output.html +87 -0
- data/ext/apex_ext/apex_src/plans/quarto-mode.md +442 -0
- data/ext/apex_ext/apex_src/src/_README.md +85 -32
- data/ext/apex_ext/apex_src/src/apex.c +770 -200
- data/ext/apex_ext/apex_src/src/ast_rtf.c +848 -0
- data/ext/apex_ext/apex_src/src/ast_terminal.c +184 -7
- data/ext/apex_ext/apex_src/src/extensions/abbreviations.c +10 -3
- data/ext/apex_ext/apex_src/src/extensions/advanced_tables.c +7 -11
- data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.c +467 -0
- data/ext/apex_ext/apex_src/src/extensions/bear_image_attrs.h +27 -0
- data/ext/apex_ext/apex_src/src/extensions/callouts.c +400 -4
- data/ext/apex_ext/apex_src/src/extensions/callouts.h +15 -5
- data/ext/apex_ext/apex_src/src/extensions/citations.c +26 -5
- data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.c +632 -0
- data/ext/apex_ext/apex_src/src/extensions/code_fence_attrs.h +22 -0
- data/ext/apex_ext/apex_src/src/extensions/concordance.c +632 -0
- data/ext/apex_ext/apex_src/src/extensions/definition_list.c +129 -15
- data/ext/apex_ext/apex_src/src/extensions/grid_tables.c +1050 -121
- data/ext/apex_ext/apex_src/src/extensions/html_markdown.c +569 -16
- data/ext/apex_ext/apex_src/src/extensions/ial.c +502 -52
- data/ext/apex_ext/apex_src/src/extensions/ial.h +2 -1
- data/ext/apex_ext/apex_src/src/extensions/includes.c +532 -33
- data/ext/apex_ext/apex_src/src/extensions/includes.h +7 -1
- data/ext/apex_ext/apex_src/src/extensions/index.c +1427 -140
- data/ext/apex_ext/apex_src/src/extensions/index.h +28 -0
- data/ext/apex_ext/apex_src/src/extensions/metadata.c +200 -161
- data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.c +251 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_diagrams.h +22 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_lists.c +624 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_lists.h +35 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_polish.c +264 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_polish.h +23 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.c +307 -0
- data/ext/apex_ext/apex_src/src/extensions/quarto_shortcodes.h +21 -0
- data/ext/apex_ext/apex_src/src/extensions/raw_content.c +351 -0
- data/ext/apex_ext/apex_src/src/extensions/raw_content.h +20 -0
- data/ext/apex_ext/apex_src/src/extensions/relaxed_tables.c +117 -3
- data/ext/apex_ext/apex_src/src/extensions/special_markers.c +53 -0
- data/ext/apex_ext/apex_src/src/extensions/syntax_highlight.c +23 -1
- data/ext/apex_ext/apex_src/src/extensions/table_html_postprocess.c +83 -92
- data/ext/apex_ext/apex_src/src/extensions/toc.c +446 -25
- data/ext/apex_ext/apex_src/src/extensions/toc.h +26 -1
- data/ext/apex_ext/apex_src/src/extensions/wiki_links.c +28 -0
- data/ext/apex_ext/apex_src/src/html_renderer.c +387 -17
- data/ext/apex_ext/apex_src/src/plugin_catalog.c +517 -0
- data/ext/apex_ext/apex_src/src/plugins_remote.c +88 -14
- data/ext/apex_ext/apex_src/src/plugins_remote.h +34 -0
- data/ext/apex_ext/apex_src/src/pretty_html.c +6 -1
- data/ext/apex_ext/apex_src/tests/fixtures/comprehensive_test.md +21 -0
- data/ext/apex_ext/apex_src/tests/fixtures/images/bear_image_attributes.md +10 -0
- data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.md +19 -0
- data/ext/apex_ext/apex_src/tests/fixtures/includes/sections.txt +11 -0
- data/ext/apex_ext/apex_src/tests/fixtures/minimal_pb.md +2 -0
- data/ext/apex_ext/apex_src/tests/fixtures/obsidian-callouts.md +46 -0
- data/ext/apex_ext/apex_src/tests/fixtures/pagebreak_html_repro.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/python-callouts.md +47 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/callouts.md +3 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/code-attrs.md +3 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/diagrams.md +8 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/lists.md +19 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/raw-content.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/shortcodes.md +7 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/smoke.md +81 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto/spans.md +5 -0
- data/ext/apex_ext/apex_src/tests/fixtures/quarto-callouts.md +47 -0
- data/ext/apex_ext/apex_src/tests/fixtures/speed.md +192 -0
- data/ext/apex_ext/apex_src/tests/fixtures/tables/grid-tables.md +37 -0
- data/ext/apex_ext/apex_src/tests/paginate_cli_test.sh +16 -0
- data/ext/apex_ext/apex_src/tests/test_bear_image_attrs.c +301 -0
- data/ext/apex_ext/apex_src/tests/test_concordance.tsv +4 -0
- data/ext/apex_ext/apex_src/tests/test_escaping_repro.c +82 -0
- data/ext/apex_ext/apex_src/tests/test_extensions.c +821 -1
- data/ext/apex_ext/apex_src/tests/test_ial.c +7 -0
- data/ext/apex_ext/apex_src/tests/test_marked_integration.c +25 -0
- data/ext/apex_ext/apex_src/tests/test_metadata.c +129 -0
- data/ext/apex_ext/apex_src/tests/test_output.c +568 -2
- data/ext/apex_ext/apex_src/tests/test_runner.c +11 -0
- data/ext/apex_ext/apex_src/tests/test_tables.c +420 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/CMakeLists.txt +1 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/autolink.c +77 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/extensions/table.c +135 -5
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/blocks.c +56 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/config.h +38 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/src/main.c +1 -1
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/cmark.cpython-314.pyc +0 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/__pycache__/normalize.cpython-314.pyc +0 -0
- data/ext/apex_ext/apex_src/vendor/cmark-gfm/test/extensions.txt +69 -0
- data/ext/apex_ext/apex_src/xcode_build/CMakeScripts/ReRunCMake.make +74 -0
- data/ext/apex_ext/apex_src/xcode_build/CTestTestfile.cmake +22 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Apex +0 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/Resources/Info.plist +44 -0
- data/ext/apex_ext/apex_src/xcode_build/Debug/Apex.framework/Versions/A/_CodeSignature/CodeResources +128 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.pbxproj +5118 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/UserInterfaceState.xcuserstate +0 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/project.xcworkspace/xcuserdata/ttscoff.xcuserdatad/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/apex.xcodeproj/xcuserdata/ttscoff.xcuserdatad/xcschemes/xcschememanagement.plist +99 -0
- data/ext/apex_ext/apex_src/xcode_build/cmake_install.cmake +452 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/CMakeScripts/ReRunCMake.make +52 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmake_install.cmake +55 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.pbxproj +2455 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/cmark-gfm.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings +8 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/extensions/cmake_install.cmake +171 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/man/cmake_install.cmake +55 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmake_install.cmake +220 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_export.h +43 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/cmark-gfm_version.h +7 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/config.h +76 -0
- data/ext/apex_ext/apex_src/xcode_build/vendor/cmark-gfm/src/libcmark-gfm.pc +10 -0
- data/ext/apex_ext/extconf.rb +35 -0
- data/lib/apex/version.rb +2 -2
- metadata +117 -2
- data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/tempOptimizedIndex.dsidx +0 -0
data/ext/apex_ext/apex_src/documentation/docsets/Apex.docset/Contents/Resources/Documents/Usage.html
CHANGED
|
@@ -5,8 +5,97 @@
|
|
|
5
5
|
|
|
6
6
|
<meta charset="UTF-8">
|
|
7
7
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
8
|
-
<meta name="generator" content="Apex
|
|
8
|
+
<meta name="generator" content="Apex 1.1.12">
|
|
9
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>
|
|
10
99
|
<style>
|
|
11
100
|
body {
|
|
12
101
|
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
|
|
@@ -35,10 +124,52 @@
|
|
|
35
124
|
ins { background: #d4fcbc; text-decoration: none; }
|
|
36
125
|
del { background: #fbb6c2; text-decoration: line-through; }
|
|
37
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; }
|
|
38
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
|
+
}
|
|
39
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
|
+
|
|
40
165
|
<style>
|
|
41
|
-
|
|
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) */
|
|
42
173
|
body {
|
|
43
174
|
-webkit-font-smoothing: antialiased;
|
|
44
175
|
-moz-osx-font-smoothing: grayscale;
|
|
@@ -48,6 +179,11 @@ body {
|
|
|
48
179
|
line-height: 1.65;
|
|
49
180
|
color: #1e293b;
|
|
50
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;
|
|
51
187
|
}
|
|
52
188
|
|
|
53
189
|
/* Sidebar / Main TOC - wider on larger screens */
|
|
@@ -56,9 +192,10 @@ body {
|
|
|
56
192
|
position: fixed;
|
|
57
193
|
left: 0;
|
|
58
194
|
top: 0;
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
195
|
+
box-sizing: border-box;
|
|
196
|
+
width: var(--sidebar-width);
|
|
197
|
+
min-width: var(--sidebar-width);
|
|
198
|
+
max-width: var(--sidebar-width);
|
|
62
199
|
height: 100vh;
|
|
63
200
|
overflow-y: auto;
|
|
64
201
|
background: #1e293b;
|
|
@@ -67,7 +204,6 @@ body {
|
|
|
67
204
|
padding: 24px 20px 130px;
|
|
68
205
|
font-size: 14px;
|
|
69
206
|
z-index: 100;
|
|
70
|
-
margin-right: 1rem;
|
|
71
207
|
box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
|
|
72
208
|
transition: transform 0.3s ease;
|
|
73
209
|
}
|
|
@@ -116,11 +252,6 @@ body {
|
|
|
116
252
|
font-weight: 500;
|
|
117
253
|
}
|
|
118
254
|
|
|
119
|
-
/* Body margin for sidebar */
|
|
120
|
-
body {
|
|
121
|
-
margin-left: 270px;
|
|
122
|
-
}
|
|
123
|
-
|
|
124
255
|
/* Hamburger menu button */
|
|
125
256
|
.hamburger-menu {
|
|
126
257
|
display: none;
|
|
@@ -136,6 +267,7 @@ body {
|
|
|
136
267
|
color: rgba(255, 255, 255, 0.9);
|
|
137
268
|
font-size: 20px;
|
|
138
269
|
line-height: 1;
|
|
270
|
+
box-sizing: border-box;
|
|
139
271
|
width: 44px;
|
|
140
272
|
height: 44px;
|
|
141
273
|
align-items: center;
|
|
@@ -153,9 +285,7 @@ body {
|
|
|
153
285
|
|
|
154
286
|
/* Move hamburger to the right of the sidebar when menu is open */
|
|
155
287
|
.hamburger-menu.active {
|
|
156
|
-
left: calc(
|
|
157
|
-
250px + 12px
|
|
158
|
-
); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
|
|
288
|
+
left: calc(var(--sidebar-width) + 12px);
|
|
159
289
|
}
|
|
160
290
|
|
|
161
291
|
.hamburger-menu.active {
|
|
@@ -251,7 +381,7 @@ body {
|
|
|
251
381
|
.floating-toc {
|
|
252
382
|
position: fixed;
|
|
253
383
|
top: 0;
|
|
254
|
-
left:
|
|
384
|
+
left: var(--sidebar-offset);
|
|
255
385
|
right: 0;
|
|
256
386
|
z-index: 50;
|
|
257
387
|
opacity: 0;
|
|
@@ -677,7 +807,7 @@ ol ul {
|
|
|
677
807
|
}
|
|
678
808
|
|
|
679
809
|
body {
|
|
680
|
-
margin
|
|
810
|
+
margin: 2rem 1rem;
|
|
681
811
|
}
|
|
682
812
|
|
|
683
813
|
.floating-toc {
|
|
@@ -687,7 +817,7 @@ ol ul {
|
|
|
687
817
|
|
|
688
818
|
</style></head>
|
|
689
819
|
|
|
690
|
-
<body>
|
|
820
|
+
<body class="code-highlighted">
|
|
691
821
|
<div class="floating-toc" id="floating-toc">
|
|
692
822
|
<div class="floating-toc-container">
|
|
693
823
|
<div class="floating-toc-header">
|
|
@@ -702,174 +832,219 @@ ol ul {
|
|
|
702
832
|
<button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
|
|
703
833
|
<div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
|
|
704
834
|
|
|
705
|
-
<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>
|
|
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>
|
|
706
836
|
|
|
707
837
|
<h1 id="usage">
|
|
708
838
|
Usage
|
|
709
839
|
</h1>
|
|
710
|
-
<nav class="page-toc" id="page-toc-top"><ul><li><a href="#usage">Usage</a><ul><li><a href="#command-line">Command
|
|
840
|
+
<nav class="page-toc" id="page-toc-top"><ul><li><a href="#usage">Usage</a><ul><li><a href="#command-line">Command Line</a><ul><li><a href="#basic-conversion">Basic Conversion</a></li><li><a href="#reading-from-stdin">Reading from stdin</a></li><li><a href="#preprocessing-with-md-fixup">Preprocessing with md-fixup</a></li><li><a href="#writing-to-a-file">Writing to a File</a></li></ul></li><li><a href="#processor-modes">Processor Modes</a></li><li><a href="#output-options">Output Options</a><ul><li><a href="#standalone-html-document">Standalone HTML Document</a></li><li><a href="#with-custom-title">With Custom Title</a></li><li><a href="#with-stylesheet">With Stylesheet</a></li><li><a href="#pretty-printed-html">Pretty-Printed HTML</a></li></ul></li><li><a href="#header-ids">Header IDs</a><ul><li><a href="#default-behavior">Default Behavior</a></li><li><a href="#different-id-formats">Different ID Formats</a></li><li><a href="#disable-header-ids">Disable Header IDs</a></li><li><a href="#use-anchor-tags">Use Anchor Tags</a></li></ul></li><li><a href="#tables">Tables</a><ul><li><a href="#standard-tables">Standard Tables</a></li><li><a href="#relaxed-tables">Relaxed Tables</a></li></ul></li><li><a href="#critic-markup">Critic Markup</a><ul><li><a href="#review-mode-default">Review Mode (Default)</a></li><li><a href="#accept-all-changes">Accept All Changes</a></li><li><a href="#reject-all-changes">Reject All Changes</a></li></ul></li><li><a href="#feature-flags">Feature Flags</a></li><li><a href="#configuration">Configuration</a></li><li><a href="#examples">Examples</a><ul><li><a href="#blog-post">Blog Post</a></li><li><a href="#documentation">Documentation</a></li><li><a href="#github-compatible">GitHub-Compatible</a></li></ul></li><li><a href="#programmatic-usage">Programmatic Usage</a></li></ul></li></ul></nav>
|
|
711
841
|
|
|
712
842
|
<p>
|
|
713
843
|
This page covers basic usage patterns for Apex.
|
|
714
844
|
</p>
|
|
715
845
|
|
|
716
846
|
<h2 id="command-line">
|
|
717
|
-
Command
|
|
847
|
+
Command Line
|
|
718
848
|
</h2>
|
|
719
849
|
|
|
720
850
|
<h3 id="basic-conversion">
|
|
721
|
-
Basic
|
|
851
|
+
Basic Conversion
|
|
722
852
|
</h3>
|
|
723
853
|
|
|
724
854
|
<p>
|
|
725
855
|
Convert a Markdown file to HTML:
|
|
726
856
|
</p>
|
|
727
857
|
|
|
728
|
-
<
|
|
729
|
-
|
|
858
|
+
<div class="highlight">
|
|
859
|
+
<pre><span></span>apex<span class="w"> </span>input.md<span class="w"> </span>><span class="w"> </span>output.html
|
|
860
|
+
</pre>
|
|
861
|
+
</div>
|
|
730
862
|
|
|
731
863
|
<h3 id="reading-from-stdin">
|
|
732
|
-
Reading
|
|
864
|
+
Reading from stdin
|
|
733
865
|
</h3>
|
|
734
866
|
|
|
735
|
-
<
|
|
736
|
-
|
|
867
|
+
<div class="highlight">
|
|
868
|
+
<pre><span></span>cat<span class="w"> </span>document.md<span class="w"> </span><span class="p">|</span><span class="w"> </span>apex<span class="w"> </span>><span class="w"> </span>output.html
|
|
869
|
+
</pre>
|
|
870
|
+
</div>
|
|
737
871
|
|
|
738
872
|
<p>
|
|
739
873
|
Or:
|
|
740
874
|
</p>
|
|
741
875
|
|
|
742
|
-
<
|
|
743
|
-
|
|
876
|
+
<div class="highlight">
|
|
877
|
+
<pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="s2">"# Hello"</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>apex
|
|
878
|
+
</pre>
|
|
879
|
+
</div>
|
|
880
|
+
|
|
881
|
+
<h3 id="preprocessing-with-md-fixup">
|
|
882
|
+
Preprocessing with md-fixup
|
|
883
|
+
</h3>
|
|
884
|
+
|
|
885
|
+
<p>
|
|
886
|
+
For cleaning up Markdown before processing, you can pipe through <a href="https://github.com/ttscoff/md-fixup">md-fixup</a>:
|
|
887
|
+
</p>
|
|
888
|
+
|
|
889
|
+
<div class="highlight">
|
|
890
|
+
<pre><span></span>md-fixup<span class="w"> </span>input.md<span class="w"> </span><span class="p">|</span><span class="w"> </span>apex<span class="w"> </span>><span class="w"> </span>output.html
|
|
891
|
+
</pre>
|
|
892
|
+
</div>
|
|
893
|
+
|
|
894
|
+
<p>
|
|
895
|
+
md-fixup can fix common Markdown issues and apply search-and-replace transformations before Apex processes the document.
|
|
896
|
+
</p>
|
|
744
897
|
|
|
745
898
|
<h3 id="writing-to-a-file">
|
|
746
|
-
Writing
|
|
899
|
+
Writing to a File
|
|
747
900
|
</h3>
|
|
748
901
|
|
|
749
|
-
<
|
|
750
|
-
|
|
902
|
+
<div class="highlight">
|
|
903
|
+
<pre><span></span>apex<span class="w"> </span>input.md<span class="w"> </span>-o<span class="w"> </span>output.html
|
|
904
|
+
</pre>
|
|
905
|
+
</div>
|
|
751
906
|
|
|
752
907
|
<h2 id="processor-modes">
|
|
753
|
-
Processor
|
|
908
|
+
Processor Modes
|
|
754
909
|
</h2>
|
|
755
910
|
|
|
756
911
|
<p>
|
|
757
912
|
Specify a processor mode with <code>--mode</code>:
|
|
758
913
|
</p>
|
|
759
914
|
|
|
760
|
-
<
|
|
761
|
-
|
|
915
|
+
<div class="highlight">
|
|
916
|
+
<pre><span></span><span class="c1"># Unified mode (default - all features)</span>
|
|
917
|
+
apex<span class="w"> </span>document.md
|
|
762
918
|
|
|
763
|
-
<span class="
|
|
764
|
-
apex
|
|
919
|
+
<span class="c1"># GFM mode</span>
|
|
920
|
+
apex<span class="w"> </span>--mode<span class="w"> </span>gfm<span class="w"> </span>document.md
|
|
765
921
|
|
|
766
|
-
<span class="
|
|
767
|
-
apex
|
|
922
|
+
<span class="c1"># Kramdown mode</span>
|
|
923
|
+
apex<span class="w"> </span>--mode<span class="w"> </span>kramdown<span class="w"> </span>document.md
|
|
768
924
|
|
|
769
|
-
<span class="
|
|
770
|
-
apex
|
|
925
|
+
<span class="c1"># MultiMarkdown mode</span>
|
|
926
|
+
apex<span class="w"> </span>--mode<span class="w"> </span>mmd<span class="w"> </span>document.md
|
|
771
927
|
|
|
772
|
-
<span class="
|
|
773
|
-
apex
|
|
774
|
-
</
|
|
928
|
+
<span class="c1"># CommonMark mode</span>
|
|
929
|
+
apex<span class="w"> </span>--mode<span class="w"> </span>commonmark<span class="w"> </span>document.md
|
|
930
|
+
</pre>
|
|
931
|
+
</div>
|
|
775
932
|
|
|
776
933
|
<p>
|
|
777
934
|
See <a href="Modes.html">Modes</a> for details on what each mode supports.
|
|
778
935
|
</p>
|
|
779
936
|
|
|
780
937
|
<h2 id="output-options">
|
|
781
|
-
Output
|
|
938
|
+
Output Options
|
|
782
939
|
</h2>
|
|
783
940
|
|
|
784
941
|
<h3 id="standalone-html-document">
|
|
785
|
-
Standalone HTML
|
|
942
|
+
Standalone HTML Document
|
|
786
943
|
</h3>
|
|
787
944
|
|
|
788
945
|
<p>
|
|
789
946
|
Generate a complete HTML document with <code><html></code>, <code><head></code>, and <code><body></code> tags:
|
|
790
947
|
</p>
|
|
791
948
|
|
|
792
|
-
<
|
|
793
|
-
|
|
949
|
+
<div class="highlight">
|
|
950
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--standalone
|
|
951
|
+
</pre>
|
|
952
|
+
</div>
|
|
794
953
|
|
|
795
954
|
<h3 id="with-custom-title">
|
|
796
|
-
With Custom
|
|
955
|
+
With Custom Title
|
|
797
956
|
</h3>
|
|
798
957
|
|
|
799
|
-
<
|
|
800
|
-
|
|
958
|
+
<div class="highlight">
|
|
959
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">"My Document"</span>
|
|
960
|
+
</pre>
|
|
961
|
+
</div>
|
|
801
962
|
|
|
802
963
|
<h3 id="with-stylesheet">
|
|
803
|
-
With
|
|
964
|
+
With Stylesheet
|
|
804
965
|
</h3>
|
|
805
966
|
|
|
806
|
-
<
|
|
807
|
-
|
|
967
|
+
<div class="highlight">
|
|
968
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--standalone<span class="w"> </span>--style<span class="w"> </span>styles.css<span class="w"> </span>--title<span class="w"> </span><span class="s2">"My Document"</span>
|
|
969
|
+
</pre>
|
|
970
|
+
</div>
|
|
808
971
|
|
|
809
972
|
<h3 id="pretty-printed-html">
|
|
810
|
-
Pretty-Printed
|
|
973
|
+
Pretty-Printed HTML
|
|
811
974
|
</h3>
|
|
812
975
|
|
|
813
976
|
<p>
|
|
814
977
|
Format HTML with indentation and whitespace:
|
|
815
978
|
</p>
|
|
816
979
|
|
|
817
|
-
<
|
|
818
|
-
|
|
980
|
+
<div class="highlight">
|
|
981
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--pretty
|
|
982
|
+
</pre>
|
|
983
|
+
</div>
|
|
819
984
|
|
|
820
985
|
<h2 id="header-ids">
|
|
821
|
-
Header
|
|
986
|
+
Header IDs
|
|
822
987
|
</h2>
|
|
823
988
|
|
|
824
989
|
<h3 id="default-behavior">
|
|
825
|
-
Default
|
|
990
|
+
Default Behavior
|
|
826
991
|
</h3>
|
|
827
992
|
|
|
828
993
|
<p>
|
|
829
994
|
By default, Apex generates header IDs automatically using GFM rules:
|
|
830
995
|
</p>
|
|
831
996
|
|
|
832
|
-
<
|
|
833
|
-
</
|
|
997
|
+
<div class="highlight">
|
|
998
|
+
<pre><span></span><span class="gh"># My Header</span>
|
|
999
|
+
</pre>
|
|
1000
|
+
</div>
|
|
834
1001
|
|
|
835
1002
|
<p>
|
|
836
1003
|
Becomes:
|
|
837
1004
|
</p>
|
|
838
1005
|
|
|
839
|
-
<
|
|
840
|
-
|
|
1006
|
+
<div class="highlight">
|
|
1007
|
+
<pre><span></span><span class="p"><</span><span class="nt">h1</span> <span class="na">id</span><span class="o">=</span><span class="s">"my-header"</span><span class="p">></span>My Header<span class="p"></</span><span class="nt">h1</span><span class="p">></span>
|
|
1008
|
+
</pre>
|
|
1009
|
+
</div>
|
|
841
1010
|
|
|
842
1011
|
<h3 id="different-id-formats">
|
|
843
|
-
Different
|
|
1012
|
+
Different ID Formats
|
|
844
1013
|
</h3>
|
|
845
1014
|
|
|
846
|
-
<
|
|
847
|
-
|
|
1015
|
+
<div class="highlight">
|
|
1016
|
+
<pre><span></span><span class="c1"># GFM format (default)</span>
|
|
1017
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--id-format<span class="w"> </span>gfm
|
|
848
1018
|
|
|
849
|
-
<span class="
|
|
850
|
-
apex document.md
|
|
1019
|
+
<span class="c1"># MultiMarkdown format</span>
|
|
1020
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--id-format<span class="w"> </span>mmd
|
|
851
1021
|
|
|
852
|
-
<span class="
|
|
853
|
-
apex document.md
|
|
854
|
-
</
|
|
1022
|
+
<span class="c1"># Kramdown format</span>
|
|
1023
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--id-format<span class="w"> </span>kramdown
|
|
1024
|
+
</pre>
|
|
1025
|
+
</div>
|
|
855
1026
|
|
|
856
1027
|
<h3 id="disable-header-ids">
|
|
857
|
-
Disable
|
|
1028
|
+
Disable Header IDs
|
|
858
1029
|
</h3>
|
|
859
1030
|
|
|
860
|
-
<
|
|
861
|
-
|
|
1031
|
+
<div class="highlight">
|
|
1032
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--no-ids
|
|
1033
|
+
</pre>
|
|
1034
|
+
</div>
|
|
862
1035
|
|
|
863
1036
|
<h3 id="use-anchor-tags">
|
|
864
|
-
Use Anchor
|
|
1037
|
+
Use Anchor Tags
|
|
865
1038
|
</h3>
|
|
866
1039
|
|
|
867
1040
|
<p>
|
|
868
1041
|
Generate <code><a></code> anchor tags instead of <code>id</code> attributes:
|
|
869
1042
|
</p>
|
|
870
1043
|
|
|
871
|
-
<
|
|
872
|
-
|
|
1044
|
+
<div class="highlight">
|
|
1045
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--header-anchors
|
|
1046
|
+
</pre>
|
|
1047
|
+
</div>
|
|
873
1048
|
|
|
874
1049
|
<p>
|
|
875
1050
|
See <a href="Header-IDs.html">Header IDs</a> for complete details.
|
|
@@ -880,91 +1055,104 @@ apex document.md <span class="nt">--id-format</span> kramdown
|
|
|
880
1055
|
</h2>
|
|
881
1056
|
|
|
882
1057
|
<h3 id="standard-tables">
|
|
883
|
-
Standard
|
|
1058
|
+
Standard Tables
|
|
884
1059
|
</h3>
|
|
885
1060
|
|
|
886
|
-
<
|
|
1061
|
+
<div class="highlight">
|
|
1062
|
+
<pre><span></span>| Header 1 | Header 2 |
|
|
887
1063
|
| -------- | -------- |
|
|
888
1064
|
| Cell 1 | Cell 2 |
|
|
889
|
-
</
|
|
1065
|
+
</pre>
|
|
1066
|
+
</div>
|
|
890
1067
|
|
|
891
1068
|
<h3 id="relaxed-tables">
|
|
892
|
-
Relaxed
|
|
1069
|
+
Relaxed Tables
|
|
893
1070
|
</h3>
|
|
894
1071
|
|
|
895
1072
|
<p>
|
|
896
1073
|
In unified and kramdown modes, relaxed tables are enabled by default:
|
|
897
1074
|
</p>
|
|
898
1075
|
|
|
899
|
-
<
|
|
900
|
-
|
|
1076
|
+
<div class="highlight">
|
|
1077
|
+
<pre><span></span>one | two
|
|
901
1078
|
1 | 2
|
|
902
|
-
</
|
|
1079
|
+
</pre>
|
|
1080
|
+
</div>
|
|
903
1081
|
|
|
904
1082
|
<p>
|
|
905
1083
|
No separator row required! To disable:
|
|
906
1084
|
</p>
|
|
907
1085
|
|
|
908
|
-
<
|
|
909
|
-
|
|
1086
|
+
<div class="highlight">
|
|
1087
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--no-relaxed-tables
|
|
1088
|
+
</pre>
|
|
1089
|
+
</div>
|
|
910
1090
|
|
|
911
1091
|
<h2 id="critic-markup">
|
|
912
|
-
Critic
|
|
1092
|
+
Critic Markup
|
|
913
1093
|
</h2>
|
|
914
1094
|
|
|
915
1095
|
<h3 id="review-mode-default">
|
|
916
|
-
Review Mode
|
|
1096
|
+
Review Mode (Default)
|
|
917
1097
|
</h3>
|
|
918
1098
|
|
|
919
1099
|
<p>
|
|
920
1100
|
Show all changes with HTML markup:
|
|
921
1101
|
</p>
|
|
922
1102
|
|
|
923
|
-
<
|
|
924
|
-
|
|
1103
|
+
<div class="highlight">
|
|
1104
|
+
<pre><span></span>apex<span class="w"> </span>document.md
|
|
1105
|
+
</pre>
|
|
1106
|
+
</div>
|
|
925
1107
|
|
|
926
1108
|
<h3 id="accept-all-changes">
|
|
927
|
-
Accept All
|
|
1109
|
+
Accept All Changes
|
|
928
1110
|
</h3>
|
|
929
1111
|
|
|
930
1112
|
<p>
|
|
931
1113
|
Apply all additions, remove all deletions:
|
|
932
1114
|
</p>
|
|
933
1115
|
|
|
934
|
-
<
|
|
935
|
-
|
|
1116
|
+
<div class="highlight">
|
|
1117
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--accept
|
|
1118
|
+
</pre>
|
|
1119
|
+
</div>
|
|
936
1120
|
|
|
937
1121
|
<h3 id="reject-all-changes">
|
|
938
|
-
Reject All
|
|
1122
|
+
Reject All Changes
|
|
939
1123
|
</h3>
|
|
940
1124
|
|
|
941
1125
|
<p>
|
|
942
1126
|
Revert all changes, keep original text:
|
|
943
1127
|
</p>
|
|
944
1128
|
|
|
945
|
-
<
|
|
946
|
-
|
|
1129
|
+
<div class="highlight">
|
|
1130
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--reject
|
|
1131
|
+
</pre>
|
|
1132
|
+
</div>
|
|
947
1133
|
|
|
948
1134
|
<h2 id="feature-flags">
|
|
949
|
-
Feature
|
|
1135
|
+
Feature Flags
|
|
950
1136
|
</h2>
|
|
951
1137
|
|
|
952
1138
|
<p>
|
|
953
1139
|
Disable specific features:
|
|
954
1140
|
</p>
|
|
955
1141
|
|
|
956
|
-
<
|
|
957
|
-
|
|
1142
|
+
<div class="highlight">
|
|
1143
|
+
<pre><span></span><span class="c1"># Disable tables</span>
|
|
1144
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--no-tables
|
|
958
1145
|
|
|
959
|
-
<span class="
|
|
960
|
-
apex document.md
|
|
1146
|
+
<span class="c1"># Disable footnotes</span>
|
|
1147
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--no-footnotes
|
|
961
1148
|
|
|
962
|
-
<span class="
|
|
963
|
-
apex document.md
|
|
1149
|
+
<span class="c1"># Disable smart typography</span>
|
|
1150
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--no-smart
|
|
964
1151
|
|
|
965
|
-
<span class="
|
|
966
|
-
apex document.md
|
|
967
|
-
</
|
|
1152
|
+
<span class="c1"># Disable math</span>
|
|
1153
|
+
apex<span class="w"> </span>document.md<span class="w"> </span>--no-math
|
|
1154
|
+
</pre>
|
|
1155
|
+
</div>
|
|
968
1156
|
|
|
969
1157
|
<h2 id="configuration">
|
|
970
1158
|
Configuration
|
|
@@ -999,28 +1187,34 @@ apex document.md <span class="nt">--no-math</span>
|
|
|
999
1187
|
</h2>
|
|
1000
1188
|
|
|
1001
1189
|
<h3 id="blog-post">
|
|
1002
|
-
Blog
|
|
1190
|
+
Blog Post
|
|
1003
1191
|
</h3>
|
|
1004
1192
|
|
|
1005
|
-
<
|
|
1006
|
-
|
|
1193
|
+
<div class="highlight">
|
|
1194
|
+
<pre><span></span>apex<span class="w"> </span>post.md<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">"My Blog Post"</span><span class="w"> </span>--style<span class="w"> </span>blog.css<span class="w"> </span>><span class="w"> </span>post.html
|
|
1195
|
+
</pre>
|
|
1196
|
+
</div>
|
|
1007
1197
|
|
|
1008
1198
|
<h3 id="documentation">
|
|
1009
1199
|
Documentation
|
|
1010
1200
|
</h3>
|
|
1011
1201
|
|
|
1012
|
-
<
|
|
1013
|
-
|
|
1202
|
+
<div class="highlight">
|
|
1203
|
+
<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--pretty<span class="w"> </span>--standalone<span class="w"> </span>--title<span class="w"> </span><span class="s2">"Documentation"</span><span class="w"> </span>><span class="w"> </span>docs.html
|
|
1204
|
+
</pre>
|
|
1205
|
+
</div>
|
|
1014
1206
|
|
|
1015
1207
|
<h3 id="github-compatible">
|
|
1016
1208
|
GitHub-Compatible
|
|
1017
1209
|
</h3>
|
|
1018
1210
|
|
|
1019
|
-
<
|
|
1020
|
-
|
|
1211
|
+
<div class="highlight">
|
|
1212
|
+
<pre><span></span>apex<span class="w"> </span>--mode<span class="w"> </span>gfm<span class="w"> </span>document.md<span class="w"> </span>><span class="w"> </span>output.html
|
|
1213
|
+
</pre>
|
|
1214
|
+
</div>
|
|
1021
1215
|
|
|
1022
1216
|
<h2 id="programmatic-usage">
|
|
1023
|
-
Programmatic
|
|
1217
|
+
Programmatic Usage
|
|
1024
1218
|
</h2>
|
|
1025
1219
|
|
|
1026
1220
|
<p>
|