apex-ruby 1.0.17 → 1.0.20

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

@@ -5,8 +5,97 @@
 
       <meta charset="UTF-8">
       <meta name="viewport" content="width=device-width, initial-scale=1.0">
-      <meta name="generator" content="Apex 0.1.49">
+      <meta name="generator" content="Apex 1.1.12">
       <title>Document</title>
+      <style>
+        /* GitHub-style syntax highlighting for Pygments and Skylighting */
+        /* Don't apply background to wrapper when code highlighting is enabled - let default styles handle it */
+        .code-highlighted .highlight, .code-highlighted .sourceCode { background: inherit; border-radius: 6px; padding: 16px; overflow-x: auto; }
+        .highlight pre, .sourceCode pre { margin: 0; padding: 0; background: transparent; }
+        .highlight code, .sourceCode code { font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace; font-size: 12px; line-height: 1.45; }
+        /* Pygments classes */
+        .highlight .k { color: #d73a49; font-weight: 600; } /* Keyword */
+        .highlight .kt { color: #d73a49; } /* Keyword.Type */
+        .highlight .kd { color: #d73a49; font-weight: 600; } /* Keyword.Declaration */
+        .highlight .kn { color: #d73a49; } /* Keyword.Namespace */
+        .highlight .kp { color: #d73a49; } /* Keyword.Pseudo */
+        .highlight .kr { color: #d73a49; font-weight: 600; } /* Keyword.Reserved */
+        .highlight .n { color: #6f42c1; } /* Name */
+        .highlight .na { color: #6f42c1; } /* Name.Attribute */
+        .highlight .nc { color: #6f42c1; font-weight: 600; } /* Name.Class */
+        .highlight .no { color: #005cc5; } /* Name.Constant */
+        .highlight .nd { color: #6f42c1; font-weight: 600; } /* Name.Decorator */
+        .highlight .ni { color: #800080; } /* Name.Entity */
+        .highlight .ne { color: #990000; font-weight: 600; } /* Name.Exception */
+        .highlight .nf { color: #6f42c1; font-weight: 600; } /* Name.Function */
+        .highlight .nl { color: #6f42c1; } /* Name.Label */
+        .highlight .nn { color: #555; } /* Name.Namespace */
+        .highlight .nt { color: #22863a; } /* Name.Tag */
+        .highlight .nv { color: #e36209; } /* Name.Variable */
+        .highlight .s { color: #032f62; } /* String */
+        .highlight .sb { color: #032f62; } /* String.Backtick */
+        .highlight .sc { color: #032f62; } /* String.Char */
+        .highlight .sd { color: #032f62; } /* String.Doc */
+        .highlight .s2 { color: #032f62; } /* String.Double */
+        .highlight .se { color: #032f62; } /* String.Escape */
+        .highlight .sh { color: #032f62; } /* String.Heredoc */
+        .highlight .si { color: #032f62; } /* String.Interpol */
+        .highlight .sx { color: #032f62; } /* String.Other */
+        .highlight .sr { color: #032f62; } /* String.Regex */
+        .highlight .s1 { color: #032f62; } /* String.Single */
+        .highlight .ss { color: #032f62; } /* String.Symbol */
+        .highlight .c { color: #6a737d; font-style: italic; } /* Comment */
+        .highlight .c1 { color: #6a737d; font-style: italic; } /* Comment.Single */
+        .highlight .cm { color: #6a737d; font-style: italic; } /* Comment.Multiline */
+        .highlight .cp { color: #6a737d; font-weight: 600; } /* Comment.Preproc */
+        .highlight .cs { color: #6a737d; font-weight: 600; font-style: italic; } /* Comment.Special */
+        .highlight .m { color: #005cc5; } /* Literal.Number */
+        .highlight .mb { color: #005cc5; } /* Literal.Number.Bin */
+        .highlight .mf { color: #005cc5; } /* Literal.Number.Float */
+        .highlight .mh { color: #005cc5; } /* Literal.Number.Hex */
+        .highlight .mi { color: #005cc5; } /* Literal.Number.Integer */
+        .highlight .il { color: #005cc5; } /* Literal.Number.Integer.Long */
+        .highlight .mo { color: #005cc5; } /* Literal.Number.Oct */
+        .highlight .o { color: #d73a49; } /* Operator */
+        .highlight .ow { color: #d73a49; } /* Operator.Word */
+        .highlight .p { color: #24292e; } /* Punctuation */
+        .highlight .w { color: #e1e4e8; } /* Text.Whitespace */
+        /* Skylighting classes */
+        .sourceCode .kw { color: #d73a49; font-weight: 600; } /* Keyword */
+        .sourceCode .dt { color: #6f42c1; } /* DataType */
+        .sourceCode .dv { color: #005cc5; } /* DecVal */
+        .sourceCode .bn { color: #005cc5; } /* BaseN */
+        .sourceCode .fl { color: #005cc5; } /* Float */
+        .sourceCode .ch { color: #032f62; } /* Char */
+        .sourceCode .st { color: #032f62; } /* String */
+        .sourceCode .co { color: #6a737d; font-style: italic; } /* Comment */
+        .sourceCode .ot { color: #22863a; } /* Other */
+        .sourceCode .al { color: #e36209; font-weight: 600; } /* Alert */
+        .sourceCode .fu { color: #6f42c1; font-weight: 600; } /* Function */
+        .sourceCode .re { color: #032f62; } /* RegionMarker */
+        .sourceCode .er { color: #d73a49; font-weight: 600; } /* Error */
+        .sourceCode .cf { color: #d73a49; font-weight: 600; } /* ControlFlow */
+        .sourceCode .op { color: #d73a49; } /* Operator */
+        .sourceCode .pp { color: #6a737d; } /* Preprocessor */
+        .sourceCode .at { color: #005cc5; } /* Attribute */
+        .sourceCode .do { color: #6a737d; font-style: italic; } /* Documentation */
+        .sourceCode .an { color: #6a737d; font-weight: 600; } /* Annotation */
+        .sourceCode .cv { color: #6a737d; font-weight: 600; font-style: italic; } /* CommentVar */
+        .sourceCode .in { color: #6a737d; } /* Information */
+        .sourceCode .wa { color: #e36209; font-weight: 600; } /* Warning */
+        .sourceCode .im { color: #d73a49; } /* Import */
+        .sourceCode .bu { color: #005cc5; } /* BuiltIn */
+        .sourceCode .ex { color: #6f42c1; } /* Extension */
+        .sourceCode .va { color: #e36209; } /* Variable */
+        .sourceCode .ss { color: #032f62; } /* SpecialString */
+        .sourceCode .sc { color: #032f62; } /* SpecialChar */
+        .sourceCode .vs { color: #032f62; } /* VerbatimString */
+        .sourceCode .il { color: #005cc5; } /* Special */
+        /* Line numbers (Skylighting) */
+        .sourceCode.numberSource .sourceCode { counter-reset: line; }
+        .sourceCode.numberSource .sourceCode > span { position: relative; left: -4em; counter-increment: line; }
+        .sourceCode.numberSource .sourceCode > span > a:first-child::before { content: counter(line); position: relative; left: -1em; text-align: right; vertical-align: baseline; border: none; display: inline-block; min-width: 1em; padding-right: 0.5em; color: #aaa; }
+      </style>
       <style>
         body {
           font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
@@ -35,10 +124,52 @@
         ins { background: #d4fcbc; text-decoration: none; }
         del { background: #fbb6c2; text-decoration: line-through; }
         mark { background: #fff3cd; }
+        .smallcaps { font-variant: small-caps; }
+        .underline { text-decoration: underline; }
+        span.mark { background: #fff3cd; }
+        .hidden { display: none; }
+        .quarto-xref { font-variant: normal; }
         .critic.comment { background: #e7e7e7; color: #666; font-style: italic; }
+        .mkhashtag { color: #666; }
+        .mkstyledtag {
+          display: inline-block;
+          background: #e0e0e0;
+          padding: 3px 9px;
+          border-radius: 20px;
+          font-size: 0.9em;
+          line-height: 1.4;
+          color: #333;
+          margin: 0 2px;
+        }
       </style>
+        <meta name="paginate" content="symbols"/>
+      <meta name="highlight-language-only" content="true"/>
+      <meta name="code-line-numbers" content="false"/>
+      <meta name="code-highlight" content="pygments"/>
+      <meta name="sup-sub" content="true"/>
+      <meta name="relaxed-tables" content="true"/>
+      <meta name="includes" content="true"/>
+      <meta name="autolink" content="true"/>
+      <meta name="pretty" content="false"/>
+      <meta name="standalone" content="false"/>
+      <meta name="mode" content="unified"/>
+      <meta name="markdown-in-html" content="true"/>
+      <meta name="image-captions" content="true"/>
+      <meta name="wikilink-extension" content="html"/>
+      <meta name="wikilink-space" content="hyphen"/>
+      <meta name="wikilinks" content="true"/>
+      <meta name="widont" content="true"/>
+      <meta name="plugins" content="true"/>
+      <meta name="id-format" content="gfm"/>
+
   <style>
-/* Base styles */
+:root {
+  /* border-box width of the fixed sidebar; body offset includes a small gap */
+  --sidebar-width: 250px;
+  --sidebar-offset: 270px;
+}
+
+/* Base styles — override Apex standalone centering (max-width + margin: auto) */
 body {
   -webkit-font-smoothing: antialiased;
   -moz-osx-font-smoothing: grayscale;
@@ -48,6 +179,11 @@ body {
   line-height: 1.65;
   color: #1e293b;
   background-color: #fff;
+  max-width: none;
+  width: auto;
+  margin: 2rem 2rem 2rem var(--sidebar-offset);
+  padding: 0 1rem;
+  box-sizing: border-box;
 }
 
 /* Sidebar / Main TOC - wider on larger screens */
@@ -56,9 +192,10 @@ body {
   position: fixed;
   left: 0;
   top: 0;
-  width: auto;
-  min-width: 180px;
-  max-width: 250px;
+  box-sizing: border-box;
+  width: var(--sidebar-width);
+  min-width: var(--sidebar-width);
+  max-width: var(--sidebar-width);
   height: 100vh;
   overflow-y: auto;
   background: #1e293b;
@@ -67,7 +204,6 @@ body {
   padding: 24px 20px 130px;
   font-size: 14px;
   z-index: 100;
-  margin-right: 1rem;
   box-shadow: 4px 0 24px rgba(0, 0, 0, 0.08);
   transition: transform 0.3s ease;
 }
@@ -116,11 +252,6 @@ body {
   font-weight: 500;
 }
 
-/* Body margin for sidebar */
-body {
-  margin-left: 270px;
-}
-
 /* Hamburger menu button */
 .hamburger-menu {
   display: none;
@@ -136,6 +267,7 @@ body {
   color: rgba(255, 255, 255, 0.9);
   font-size: 20px;
   line-height: 1;
+  box-sizing: border-box;
   width: 44px;
   height: 44px;
   align-items: center;
@@ -153,9 +285,7 @@ body {
 
 /* Move hamburger to the right of the sidebar when menu is open */
 .hamburger-menu.active {
-  left: calc(
-    250px + 12px
-  ); /* Position just to the right of sidebar (max-width 250px + 12px padding) */
+  left: calc(var(--sidebar-width) + 12px);
 }
 
 .hamburger-menu.active {
@@ -251,7 +381,7 @@ body {
 .floating-toc {
   position: fixed;
   top: 0;
-  left: 270px;
+  left: var(--sidebar-offset);
   right: 0;
   z-index: 50;
   opacity: 0;
@@ -677,7 +807,7 @@ ol ul {
   }
 
   body {
-    margin-left: 0;
+    margin: 2rem 1rem;
   }
 
   .floating-toc {
@@ -687,7 +817,7 @@ ol ul {
 
 </style></head>
 
-  <body>
+  <body class="code-highlighted">
 <div class="floating-toc" id="floating-toc">
   <div class="floating-toc-container">
     <div class="floating-toc-header">
@@ -702,12 +832,12 @@ ol ul {
 <button class="hamburger-menu" id="hamburger-menu" aria-label="Toggle navigation"></button>
 <div class="mobile-menu-overlay" id="mobile-menu-overlay"></div>
 
-<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
+<nav class="main-toc"><ul><li><a href="Home.html">Home</a></li><li><a href="Getting-Started.html">Getting Started</a></li><li><a href="Installation.html">Installation</a></li><li><a href="Usage.html">Usage</a></li><li><a href="Syntax.html">Syntax</a></li><li><a href="Callouts.html">Callouts</a></li><li><a href="Tables.html">Tables</a></li><li><a href="Inline-Attribute-Lists.html">Inline Attribute Lists</a></li><li><a href="Modes.html">Modes</a></li><li><a href="Quarto-Mode.html">Quarto Mode</a></li><li><a href="Command-Line-Options.html">Command Line Options</a></li><li><a href="Rendering-Markdown-In-Terminal.html">Rendering Markdown in the Terminal</a></li><li><a href="Generating-Man-Pages.html">Generating Man Pages</a></li><li><a href="Multi-File-Documents.html">Multi-file Documents</a></li><li><a href="Citations.html">Citations</a></li><li><a href="Indices.html">Indices</a></li><li><a href="Metadata-Transforms.html">Metadata Transforms</a></li><li><a href="Pandoc-Integration.html">Integrating with Pandoc</a></li><li><a href="Using-Apex-with-Jekyll.html">Using Apex with Jekyll</a></li><li><a href="Header-IDs.html">Header IDs</a></li><li><a href="C-API.html">C API</a></li><li><a href="Writing-Tests.html">Writing Tests</a></li><li><a href="Xcode-Integration.html">Xcode Integration</a></li><li><a href="Examples.html">Examples</a></li><li><a href="Plugins.html">Plugins</a></li><li><a href="Filters.html">Filters</a></li><li><a href="Troubleshooting.html">Troubleshooting</a></li><li><a href="Credits.html">Credits</a></li></ul></nav>
 
     <h1 id="configuration">
       Configuration
     </h1>
-<nav class="page-toc" id="page-toc-top"><ul><li><a href="#configuration">Configuration</a><ul><li><a href="#configuration-sources">Configuration sources</a></li><li><a href="#global-config-file-configyml">Global config file: config.yml</a><ul><li><a href="#example-configyml">Example config.yml</a></li></ul></li><li><a href="#reusable-config-files-with-meta-file">Reusable config files with --meta-file</a><ul><li><a href="#example-project-config-project-defaultsyml">Example project config (project-defaults.yml)</a></li></ul></li><li><a href="#per-document-metadata">Per-document metadata</a><ul><li><a href="#yaml-front-matter-example">YAML front matter example</a></li><li><a href="#multimarkdown-metadata-example">MultiMarkdown metadata example</a></li></ul></li><li><a href="#precedence-and-merging">Precedence and merging</a></li><li><a href="#available-configuration-keys">Available configuration keys</a><ul><li><a href="#boolean-options">Boolean options</a></li><li><a href="#string-options">String options</a></li></ul></li><li><a href="#putting-it-all-together">Putting it all together</a></li></ul></li></ul></nav>
+<nav class="page-toc" id="page-toc-top"><ul><li><a href="#configuration">Configuration</a><ul><li><a href="#configuration-sources">Configuration&nbsp;sources</a></li><li><a href="#global-config-file-configyml">Global config file:&nbsp;config.yml</a><ul><li><a href="#example-configyml">Example&nbsp;config.yml</a></li></ul></li><li><a href="#project-config-file-apexconfigyml">Project config file:&nbsp;.apex/config.yml</a></li><li><a href="#reusable-config-files-with-meta-file">Reusable config files with&nbsp;--meta-file</a><ul><li><a href="#example-project-config-project-defaultsyml">Example project config&nbsp;(project-defaults.yml)</a></li></ul></li><li><a href="#per-document-metadata">Per-document&nbsp;metadata</a><ul><li><a href="#yaml-front-matter-example">YAML front matter&nbsp;example</a></li><li><a href="#multimarkdown-metadata-example">MultiMarkdown metadata&nbsp;example</a></li></ul></li><li><a href="#precedence-and-merging">Precedence and&nbsp;merging</a></li><li><a href="#available-configuration-keys">Available configuration&nbsp;keys</a><ul><li><a href="#boolean-options">Boolean&nbsp;options</a></li><li><a href="#string-options">String&nbsp;options</a></li></ul></li><li><a href="#putting-it-all-together">Putting it all&nbsp;together</a></li></ul></li></ul></nav>
 
     <p>
       Apex offers a flexible configuration system so you can define defaults once and reuse them across many documents, while still allowing per-document and per-invocation overrides.
@@ -747,17 +877,17 @@ ol ul {
 
 <hr />
     <h2 id="configuration-sources">
-      Configuration sources
+      Configuration&nbsp;sources
     </h2>
 
     <p>
-      Apex can read configuration from three main places:
+      Apex can read configuration from four main places:
     </p>
 
     <ol>
 
       <li>
-<strong>        Global configuration file</strong>
+        <strong>Global configuration file</strong>
         <ul>
 
           <li>
@@ -768,8 +898,36 @@ ol ul {
 <code>~/.config/apex/config.yml</code> when <code>XDG_CONFIG_HOME</code> is not set
           </li>
 
+        </ul>
+
+      </li>
+
+      <li>
+        <strong>Project configuration file</strong>
+        <ul>
+
+          <li>
+<code>.apex/config.yml</code> in your project
+          </li>
+
           <li>
-            Loaded <strong>automatically</strong> when present if you do <strong>not</strong> pass <code>--meta-file</code>
+            Searched in this order:
+            <ul>
+
+              <li>
+                Current working directory: <code>./.apex/config.yml</code>
+              </li>
+
+              <li>
+<code>--base-dir DIR</code>: <code>DIR/.apex/config.yml</code>
+              </li>
+
+              <li>
+                Git repository root (when inside a work tree): <code>&lt;git-root&gt;/.apex/config.yml</code>
+              </li>
+
+            </ul>
+
           </li>
 
         </ul>
@@ -777,7 +935,7 @@ ol ul {
       </li>
 
       <li>
-<strong>        External metadata files</strong>
+        <strong>External metadata files</strong>
         <ul>
 
           <li>
@@ -793,7 +951,7 @@ ol ul {
       </li>
 
       <li>
-<strong>        Per-document metadata</strong>
+        <strong>Per-document metadata</strong>
         <ul>
 
           <li>
@@ -816,11 +974,11 @@ ol ul {
 
 <hr />
     <h2 id="global-config-file-configyml">
-      Global config file: <code>config.yml</code>
+      Global config file:&nbsp;<code>config.yml</code>
     </h2>
 
     <p>
-      When you run <code>apex</code> <strong>without</strong> an explicit <code>--meta-file</code>, Apex will check for a global configuration file named <code>config.yml</code> in an XDG-aware location:
+      When you run <code>apex</code>, Apex will check for a global configuration file named <code>config.yml</code> in an XDG-aware location:
     </p>
 
     <ul>
@@ -852,7 +1010,7 @@ ol ul {
     </ul>
 
     <p>
-      If the file exists, Apex loads it <strong>as if you had passed it via <code>--meta-file</code></strong>, and merges its metadata with the document and any <code>--meta</code> command-line metadata using the normal precedence rules (see below).
+      If the file exists, Apex loads it and merges its metadata with any project config, explicit <code>--meta-file</code>, document metadata, and <code>--meta</code> command-line metadata using the normal precedence rules (see below).
     </p>
 
     <p>
@@ -880,95 +1038,139 @@ ol ul {
     </ul>
 
     <h3 id="example-configyml">
-      Example <code>config.yml</code>
+      Example&nbsp;<code>config.yml</code>
     </h3>
 
-<pre><code class="highlight language-yaml"><span class="nn">---</span>
+    <div class="highlight">
+<pre><span></span><span class="nn">---</span>
 <span class="c1"># Default processor mode and output style</span>
-<span class="na">mode</span><span class="pi">:</span> <span class="s">unified</span>
-<span class="na">standalone</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">pretty</span><span class="pi">:</span> <span class="kc">true</span>
+<span class="nt">mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">unified</span>
+<span class="nt">standalone</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">pretty</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 
 <span class="c1"># Locale and quotation style</span>
-<span class="na">language</span><span class="pi">:</span> <span class="s">en</span>
-<span class="na">quoteslanguage</span><span class="pi">:</span> <span class="s">english</span>
+<span class="nt">language</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">en</span>
+<span class="nt">quoteslanguage</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">english</span>
 
 <span class="c1"># Common feature flags</span>
-<span class="na">autolink</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">includes</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">relaxed-tables</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">sup-sub</span><span class="pi">:</span> <span class="kc">true</span>
+<span class="nt">autolink</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">includes</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">relaxed-tables</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">sup-sub</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 
 <span class="c1"># Index and bibliography defaults</span>
-<span class="na">indices</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">group-index-by-letter</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">bibliography</span><span class="pi">:</span> <span class="s">references.bib</span>
-<span class="na">csl</span><span class="pi">:</span> <span class="s">apa.csl</span>
+<span class="nt">indices</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">group-index-by-letter</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">bibliography</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">references.bib</span>
+<span class="nt">csl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">apa.csl</span>
+
+<span class="c1"># Syntax highlighting (optional)</span>
+<span class="nt">code-highlight</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pygments</span>
+<span class="nt">code-line-numbers</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">highlight-language-only</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 <span class="nn">---</span>
-</code></pre>
+    </pre>
+  </div>
 
   <p>
     With this configuration in place, a simple command like:
   </p>
 
-<pre><code class="highlight language-bash">apex document.md
-</code></pre>
+  <div class="highlight">
+<pre><span></span>apex<span class="w"> </span>document.md
+  </pre>
+</div>
 
 <p>
   will automatically use your global defaults. You can then override any of them with per-document metadata or CLI flags when needed.
 </p>
 
+<hr />
+<h2 id="project-config-file-apexconfigyml">
+  Project config file:&nbsp;<code>.apex/config.yml</code>
+</h2>
+
+<p>
+  For <strong>project-level defaults</strong>, you can add a <code>.apex/config.yml</code> file to your project. Apex will look for the first existing file in this order:
+</p>
+
+<ol>
+
+  <li>
+<code>./.apex/config.yml</code> (current working directory)
+  </li>
+
+  <li>
+<code>BASE/.apex/config.yml</code> when you pass <code>--base-dir BASE</code>
+  </li>
+
+  <li>
+<code>&lt;git-root&gt;/.apex/config.yml</code> when the current directory is inside a Git work tree
+  </li>
+
+</ol>
+
+<p>
+  If found, Apex merges the project config <strong>on top of</strong> the global config, so project keys override global ones while still inheriting unspecified global defaults.
+</p>
+
 <hr />
 <h2 id="reusable-config-files-with-meta-file">
-  Reusable config files with <code>--meta-file</code>
+  Reusable config files with&nbsp;<code>--meta-file</code>
 </h2>
 
 <p>
-  For <strong>project-specific</strong> or <strong>task-specific</strong> configurations, use <code>--meta-file</code> to point to a reusable metadata file:
+  For additional <strong>project-specific</strong> or <strong>task-specific</strong> configurations, use <code>--meta-file</code> to point to a reusable metadata file:
 </p>
 
-<pre><code class="highlight language-bash">apex document.md <span class="nt">--meta-file</span> project-defaults.yml
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>document.md<span class="w"> </span>--meta-file<span class="w"> </span>project-defaults.yml
+</pre>
+</div>
 
 <p>
   These files use the same metadata keys as <code>config.yml</code> and document front matter.
 </p>
 
 <h3 id="example-project-config-project-defaultsyml">
-  Example project config (<code>project-defaults.yml</code>)
+  Example project config&nbsp;(<code>project-defaults.yml</code>)
 </h3>
 
-<pre><code class="highlight language-yaml"><span class="nn">---</span>
-<span class="na">mode</span><span class="pi">:</span> <span class="s">unified</span>
-<span class="na">standalone</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">pretty</span><span class="pi">:</span> <span class="kc">true</span>
+<div class="highlight">
+<pre><span></span><span class="nn">---</span>
+<span class="nt">mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">unified</span>
+<span class="nt">standalone</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">pretty</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 
 <span class="c1"># Project-specific bibliography</span>
-<span class="na">bibliography</span><span class="pi">:</span> <span class="s">project-refs.bib</span>
-<span class="na">csl</span><span class="pi">:</span> <span class="s">chicago-note-bibliography.csl</span>
+<span class="nt">bibliography</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">project-refs.bib</span>
+<span class="nt">csl</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">chicago-note-bibliography.csl</span>
 
 <span class="c1"># Enable wiki links and relaxed tables for this project</span>
-<span class="na">wikilinks</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">relaxed-tables</span><span class="pi">:</span> <span class="kc">true</span>
+<span class="nt">wikilinks</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<span class="nt">relaxed-tables</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 <span class="nn">---</span>
-</code></pre>
+</pre>
+</div>
 
 <p>
   You can reuse the same <code>project-defaults.yml</code> for many documents:
 </p>
 
-<pre><code class="highlight language-bash">apex chapter1.md <span class="nt">--meta-file</span> project-defaults.yml
-apex chapter2.md <span class="nt">--meta-file</span> project-defaults.yml
-apex appendix.md <span class="nt">--meta-file</span> project-defaults.yml
-</code></pre>
+<div class="highlight">
+<pre><span></span>apex<span class="w"> </span>chapter1.md<span class="w"> </span>--meta-file<span class="w"> </span>project-defaults.yml
+apex<span class="w"> </span>chapter2.md<span class="w"> </span>--meta-file<span class="w"> </span>project-defaults.yml
+apex<span class="w"> </span>appendix.md<span class="w"> </span>--meta-file<span class="w"> </span>project-defaults.yml
+</pre>
+</div>
 
 <p>
-  If a global <code>config.yml</code> is also present, the <strong>explicit</strong> <code>--meta-file</code> still participates as the “file metadata” layer; precedence is determined by the rules below.
+  If global and/or project config files are also present, the <strong>explicit</strong> <code>--meta-file</code> is merged on top of them; overall precedence is determined by the rules below.
 </p>
 
 <hr />
 <h2 id="per-document-metadata">
-  Per-document metadata
+  Per-document&nbsp;metadata
 </h2>
 
 <p>
@@ -976,31 +1178,34 @@ apex appendix.md <span class="nt">--meta-file</span> project-defaults.yml
 </p>
 
 <h3 id="yaml-front-matter-example">
-  YAML front matter example
+  YAML front matter&nbsp;example
 </h3>
 
-<pre><code class="highlight language-markdown"><span class="nn">---</span>
-<span class="na">title</span><span class="pi">:</span> <span class="s">My Research Paper</span>
-<span class="na">author</span><span class="pi">:</span> <span class="s">Jane Doe</span>
-<span class="na">mode</span><span class="pi">:</span> <span class="s">unified</span>
-<span class="na">standalone</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">pretty</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">indices</span><span class="pi">:</span> <span class="kc">false</span>
-<span class="na">wikilinks</span><span class="pi">:</span> <span class="kc">true</span>
-<span class="na">bibliography</span><span class="pi">:</span> <span class="s">references.bib</span>
-<span class="na">language</span><span class="pi">:</span> <span class="s">en</span>
-<span class="na">quoteslanguage</span><span class="pi">:</span> <span class="s">english</span>
-<span class="nn">---</span>
+<div class="highlight">
+<pre><span></span>---
+title: My Research Paper
+author: Jane Doe
+mode: unified
+standalone: true
+pretty: true
+indices: false
+wikilinks: true
+bibliography: references.bib
+language: en
+<span class="gu">quoteslanguage: english</span>
+<span class="gu">---</span>
 
 <span class="gh"># Introduction</span>
 ...
-</code></pre>
+</pre>
+</div>
 
 <h3 id="multimarkdown-metadata-example">
-  MultiMarkdown metadata example
+  MultiMarkdown metadata&nbsp;example
 </h3>
 
-<pre><code class="highlight language-markdown">Title: My Research Paper
+<div class="highlight">
+<pre><span></span>Title: My Research Paper
 Author: Jane Doe
 Mode: unified
 Standalone: true
@@ -1013,7 +1218,8 @@ Quotes Language: english
 
 <span class="gh"># Introduction</span>
 ...
-</code></pre>
+</pre>
+</div>
 
 <p>
   Apex normalizes keys (case-insensitive, ignores spaces and dashes), so <code>Quotes Language</code>, <code>quoteslanguage</code>, and <code>quotes-language</code> are treated equivalently.
@@ -1021,7 +1227,7 @@ Quotes Language: english
 
 <hr />
 <h2 id="precedence-and-merging">
-  Precedence and merging
+  Precedence and&nbsp;merging
 </h2>
 
 <p>
@@ -1031,11 +1237,15 @@ Quotes Language: english
 <ol>
 
   <li>
-<strong>    File metadata</strong> (lowest precedence)
+    <strong>File metadata</strong> (lowest precedence)
     <ul>
 
       <li>
-        Global <code>config.yml</code> if present and no explicit <code>--meta-file</code> was given
+        Global <code>config.yml</code> (if present)
+      </li>
+
+      <li>
+        Project <code>.apex/config.yml</code> (if present)
       </li>
 
       <li>
@@ -1047,7 +1257,7 @@ Quotes Language: english
   </li>
 
   <li>
-<strong>    Document metadata</strong>
+    <strong>Document metadata</strong>
     <ul>
 
       <li>
@@ -1059,7 +1269,7 @@ Quotes Language: english
   </li>
 
   <li>
-<strong>    Command-line metadata</strong>
+    <strong>Command-line metadata</strong>
     <ul>
 
       <li>
@@ -1071,7 +1281,7 @@ Quotes Language: english
   </li>
 
   <li>
-<strong>    Command-line flags</strong>
+    <strong>Command-line flags</strong>
     <ul>
 
       <li>
@@ -1110,7 +1320,7 @@ Quotes Language: english
 
 <hr />
 <h2 id="available-configuration-keys">
-  Available configuration keys
+  Available configuration&nbsp;keys
 </h2>
 
 <p>
@@ -1118,7 +1328,7 @@ Quotes Language: english
 </p>
 
 <h3 id="boolean-options">
-  Boolean options
+  Boolean&nbsp;options
 </h3>
 
 <p>
@@ -1142,7 +1352,7 @@ Quotes Language: english
 </ul>
 
 <p>
-<strong>  Supported boolean keys include:</strong>
+  <strong>Supported boolean keys include:</strong>
 </p>
 
 <ul>
@@ -1163,6 +1373,10 @@ Quotes Language: english
 <code>relaxed-tables</code> – Enable relaxed table parsing
   </li>
 
+  <li>
+<code>per-cell-alignment</code> – Enable per-cell alignment markers (colons at start/end of cells)
+  </li>
+
   <li>
 <code>alpha-lists</code> – Enable alphabetic list markers
   </li>
@@ -1255,10 +1469,58 @@ Quotes Language: english
 <code>plugins</code> – Enable plugin processing for this document (see <a href="Plugins.html">Plugins</a>)
   </li>
 
+  <li>
+<code>code-line-numbers</code> – Include line numbers in syntax-highlighted code blocks
+  </li>
+
+  <li>
+<code>highlight-language-only</code> – Only highlight code blocks that have a language specified
+  </li>
+
+  <li>
+<code>widont</code> – Prevent short widows in headings by inserting non-breaking spaces between trailing words
+  </li>
+
+  <li>
+<code>code-is-poetry</code> – Treat code blocks without a language as poetry (adds <code>poetry</code> class, implies <code>highlight-language-only</code>)
+  </li>
+
+  <li>
+<code>markdown-in-html</code> – Enable markdown processing inside HTML blocks with markdown attributes
+  </li>
+
+  <li>
+<code>random-footnote-ids</code> – Use hash-based footnote IDs to avoid collisions when combining documents
+  </li>
+
+  <li>
+<code>hashtags</code> – Convert <code>#tags</code> into span-wrapped hashtags
+  </li>
+
+  <li>
+<code>style-hashtags</code> – Use <code>mkstyledtag</code> class instead of <code>mkhashtag</code> for hashtags
+  </li>
+
+  <li>
+<code>proofreader</code> – Treat <code>==highlight==</code> and <code>~~delete~~</code> as CriticMarkup syntax
+  </li>
+
+  <li>
+<code>hr-page-break</code> – Replace <code>&lt;hr&gt;</code> elements with Marked-style page break divs
+  </li>
+
+  <li>
+<code>title-from-h1</code> – Use the first H1 as document title when none is specified
+  </li>
+
+  <li>
+<code>page-break-before-footnotes</code> – Insert a page break before the footnotes section
+  </li>
+
 </ul>
 
 <h3 id="string-options">
-  String options
+  String&nbsp;options
 </h3>
 
 <p>
@@ -1375,6 +1637,18 @@ Quotes Language: english
 
   </li>
 
+  <li>
+<code>code-highlight</code>
+    <ul>
+
+      <li>
+        External syntax highlighting tool: <code>pygments</code> (or <code>p</code>/<code>pyg</code>), <code>skylighting</code> (or <code>s</code>/<code>sky</code>), or <code>false</code>/<code>none</code> to disable
+      </li>
+
+    </ul>
+
+  </li>
+
 </ul>
 
 <p>
@@ -1383,7 +1657,7 @@ Quotes Language: english
 
 <hr />
 <h2 id="putting-it-all-together">
-  Putting it all together
+  Putting it all&nbsp;together
 </h2>
 
 <p>
@@ -1393,15 +1667,15 @@ Quotes Language: english
 <ol>
 
   <li>
-<strong>    Global defaults</strong> in <code>config.yml</code> for your overall writing style and locale.
+    <strong>Global defaults</strong> in <code>config.yml</code> for your overall writing style and locale.
   </li>
 
   <li>
-<strong>    Project config</strong> via <code>--meta-file project.yml</code> for bibliography and project-specific settings.
+    <strong>Project config</strong> via <code>--meta-file project.yml</code> for bibliography and project-specific settings.
   </li>
 
   <li>
-<strong>    Per-document metadata</strong> for title, author, and any exceptions to the defaults.
+    <strong>Per-document metadata</strong> for title, author, and any exceptions to the defaults.
   </li>
 
   <li>