Fix heading-increment violations (#43054)

2025-12-22 19:34:15 -05:00 · 2023-09-25 16:44:48 -07:00
parent 07f481fbe7
commit d9db1c32f2
80 changed files with 98 additions and 98 deletions
--- a/content/code-security/codeql-cli/codeql-cli-manual/bqrs-decode.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/bqrs-decode.md
@@ -37,7 +37,7 @@ The decoded output will be written to standard output, unless the

 ## Primary options

-#### `<file>`
+#### `<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] BQRS file to decode.

--- a/content/code-security/codeql-cli/codeql-cli-manual/bqrs-diff.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/bqrs-diff.md
@@ -34,7 +34,7 @@ Compute the difference between two result sets.

 ## Primary options

-#### `<file1>`
+#### `<file1>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] First BQRS file to compare.

--- a/content/code-security/codeql-cli/codeql-cli-manual/bqrs-hash.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/bqrs-hash.md
@@ -34,7 +34,7 @@ codeql bqrs hash <options>... -- <file>

 ## Primary options

-#### `<file>`
+#### `<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] BQRS file to hash.

--- a/content/code-security/codeql-cli/codeql-cli-manual/bqrs-info.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/bqrs-info.md
@@ -42,7 +42,7 @@ options of [codeql bqrs decode](/code-security/codeql-cli/codeql-cli-manual/bqrs

 ## Primary options

-#### `<file>`
+#### `<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] BQRS file to show information about.

--- a/content/code-security/codeql-cli/codeql-cli-manual/bqrs-interpret.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/bqrs-interpret.md
@@ -37,7 +37,7 @@ metadata and generates output in the specified format.

 ## Primary options

-#### `<bqrs-file>`
+#### `<bqrs-file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The BQRS file to interpret.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-add-diagnostic.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-add-diagnostic.md
@@ -36,7 +36,7 @@ Available since `v2.12.6`.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to bundle.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-analyze.md
@@ -45,7 +45,7 @@ being interpreted as source-code alerts, use

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to query.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-bundle.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-bundle.md
@@ -38,7 +38,7 @@ that results, logs, TRAP, or similar should be included.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to bundle.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-cleanup.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-cleanup.md
@@ -37,7 +37,7 @@ possible on disk without degrading its future usefulness.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to clean up.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-create.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-create.md
@@ -37,7 +37,7 @@ one of the CodeQL products.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to create. This directory will
 be created, and _must not_ already exist (but its parent must).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-export-diagnostics.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-export-diagnostics.md
@@ -39,7 +39,7 @@ Available since `v2.12.6`.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-finalize.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-finalize.md
@@ -36,7 +36,7 @@ Finalize a database that was created with [codeql database init](/code-security/

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-import.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-import.md
@@ -50,7 +50,7 @@ meaningful.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-index-files.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-index-files.md
@@ -49,7 +49,7 @@ patterns, which can use the following wildcard characters:

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-init.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-init.md
@@ -43,7 +43,7 @@ extractors in the middle of an extraction operation anyway.)

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to create. This directory will
 be created, and _must not_ already exist (but its parent must).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-interpret-results.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-interpret-results.md
@@ -40,7 +40,7 @@ directory using [codeql database run-queries](/code-security/codeql-cli/codeql-c

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database that has been queried.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-print-baseline.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-print-baseline.md
@@ -45,7 +45,7 @@ source root.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-run-queries.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-run-queries.md
@@ -45,7 +45,7 @@ Alternatively, if you have only a single query to run, you might prefer

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to query.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-trace-command.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-trace-command.md
@@ -38,7 +38,7 @@ database.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database under construction. This must
 have been prepared for extraction with [codeql database init](/code-security/codeql-cli/codeql-cli-manual/database-init).
--- a/content/code-security/codeql-cli/codeql-cli-manual/database-unbundle.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-unbundle.md
@@ -36,7 +36,7 @@ This command extracts a CodeQL database archive created by [codeql database bund

 ## Primary options

-#### `<archive>`
+#### `<archive>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database archive to unzip.

--- a/content/code-security/codeql-cli/codeql-cli-manual/database-upgrade.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/database-upgrade.md
@@ -41,7 +41,7 @@ was created.

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the CodeQL database to upgrade.

--- a/content/code-security/codeql-cli/codeql-cli-manual/dataset-check.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/dataset-check.md
@@ -39,7 +39,7 @@ rule out issues in the underlying data as the cause.

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to check.

--- a/content/code-security/codeql-cli/codeql-cli-manual/dataset-cleanup.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/dataset-cleanup.md
@@ -37,7 +37,7 @@ will make it impossible to import further data into the dataset.

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to clean up.

--- a/content/code-security/codeql-cli/codeql-cli-manual/dataset-import.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/dataset-import.md
@@ -39,7 +39,7 @@ initial import.

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to create or update. The
 directory will be created if it doesn't already exist.
--- a/content/code-security/codeql-cli/codeql-cli-manual/dataset-measure.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/dataset-measure.md
@@ -42,7 +42,7 @@ optimizer.

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to measure.

--- a/content/code-security/codeql-cli/codeql-cli-manual/dataset-upgrade.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/dataset-upgrade.md
@@ -37,7 +37,7 @@ This does the same as

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to upgrade.

--- a/content/code-security/codeql-cli/codeql-cli-manual/diagnostic-add.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/diagnostic-add.md
@@ -36,7 +36,7 @@ Available since `v2.12.6`.

 ## Primary options

-#### `--markdown-message=<markdownMessage>`
+#### `--markdown-message=<markdownMessage>` <!-- markdownlint-disable-line heading-increment -->

 Message for the diagnostic, in GitHub-flavored Markdown format.

--- a/content/code-security/codeql-cli/codeql-cli-manual/diagnostic-export.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/diagnostic-export.md
@@ -36,7 +36,7 @@ Available since `v2.12.6`.

 ## Primary options

-#### `--format=<format>`
+#### `--format=<format>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The format in which to write the results. One of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/execute-language-server.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/execute-language-server.md
@@ -39,7 +39,7 @@ and output streams.

 ## Primary options

-#### `--check-errors=<checkErrors>`
+#### `--check-errors=<checkErrors>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] How to check errors. One of: ON\_CHANGE, EXPLICIT.

--- a/content/code-security/codeql-cli/codeql-cli-manual/execute-queries.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/execute-queries.md
@@ -37,7 +37,7 @@ This command should not normally be invoked directly. Instead use either

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to query.

--- a/content/code-security/codeql-cli/codeql-cli-manual/execute-query-server2.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/execute-query-server2.md
@@ -41,7 +41,7 @@ Available since `v2.10.11`.

 ## Primary options

-#### `--[no-]tuple-counting`
+#### `--[no-]tuple-counting` <!-- markdownlint-disable-line heading-increment -->

 \[Advanced] Display tuple counts for each evaluation step in the query
 evaluator logs. If the `--evaluator-log` option is provided, tuple
--- a/content/code-security/codeql-cli/codeql-cli-manual/execute-upgrades.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/execute-upgrades.md
@@ -40,7 +40,7 @@ an error will be reported.

 ## Primary options

-#### `<dataset>`
+#### `<dataset>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the raw QL dataset to upgrade.

--- a/content/code-security/codeql-cli/codeql-cli-manual/generate-extensible-predicate-metadata.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/generate-extensible-predicate-metadata.md
@@ -34,7 +34,7 @@ found in the given pack.

 ## Primary options

-#### `<pack-root-dir>`
+#### `<pack-root-dir>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The pack root directory for which we are reporting
 extensible predicate metadata.
--- a/content/code-security/codeql-cli/codeql-cli-manual/generate-log-summary.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/generate-log-summary.md
@@ -41,7 +41,7 @@ event logs directly.

 ## Primary options

-#### `<input>`
+#### `<input>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the event log file to produce a summary of.

--- a/content/code-security/codeql-cli/codeql-cli-manual/generate-query-help.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/generate-query-help.md
@@ -34,7 +34,7 @@ Generate end-user query help from .qhelp files.

 ## Primary options

-#### `<qhelpdir|suite>...`
+#### `<qhelpdir|suite>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Query help files to render. Each argument is one of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/github-upload-results.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/github-upload-results.md
@@ -44,7 +44,7 @@ This token must have the `security_events` scope.

 ## Primary options

-#### `-s, --sarif=<file>`
+#### `-s, --sarif=<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Path to the SARIF file to upload. This should be the
 output of [codeql database analyze](/code-security/codeql-cli/codeql-cli-manual/database-analyze) (or [codeql database interpret-results](/code-security/codeql-cli/codeql-cli-manual/database-interpret-results)) with `--format sarif-latest` for upload to github.com or
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-add.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-add.md
@@ -42,7 +42,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<scope/name[@range]>...`
+#### `<scope/name[@range]>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The scope, name, and optional version range of the pack to
 add to the dependency list.
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-bundle.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-bundle.md
@@ -39,7 +39,7 @@ Available since `v2.6.3`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-ci.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-ci.md
@@ -50,7 +50,7 @@ Available since `v2.12.4`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-create.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-create.md
@@ -43,7 +43,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-download.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-download.md
@@ -44,7 +44,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<scope/name[@version]|suite.qls>...`
+#### `<scope/name[@version]|suite.qls>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] List of CodeQL packs and query suites to download. If a
 query suite is provided, its instructions will be inspected and all
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-init.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-init.md
@@ -39,7 +39,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<package-name>`
+#### `<package-name>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The scope and name of the pack to create. Scope is only
 required if this pack is to be published.
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-install.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-install.md
@@ -46,7 +46,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-ls.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-ls.md
@@ -41,7 +41,7 @@ Available since `v2.7.1`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package or workspace, defaults to the current
 working directory. If this parameter points to a directory containing a
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-packlist.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-packlist.md
@@ -43,7 +43,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-publish.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-publish.md
@@ -39,7 +39,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package or workspace, defaults to the current
 working directory. If this parameter points to a directory containing a
--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-resolve-dependencies.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-resolve-dependencies.md
@@ -42,7 +42,7 @@ Available since `v2.6.0`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/pack-upgrade.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/pack-upgrade.md
@@ -43,7 +43,7 @@ Available since `v2.6.3`.

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The root directory of the package.

--- a/content/code-security/codeql-cli/codeql-cli-manual/query-compile.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/query-compile.md
@@ -39,7 +39,7 @@ output options are mostly for debugging.

 ## Primary options

-#### `<file>...`
+#### `<file>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Queries to compile. Each argument is one of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/query-decompile.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/query-decompile.md
@@ -40,7 +40,7 @@ option is specified.

 ## Primary options

-#### `<file>`
+#### `<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] QLO file to read from.

--- a/content/code-security/codeql-cli/codeql-cli-manual/query-format.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/query-format.md
@@ -34,7 +34,7 @@ Autoformat QL source code.

 ## Primary options

-#### `<file>...`
+#### `<file>...` <!-- markdownlint-disable-line heading-increment -->

 One or more `.ql` or `.qll` source files to autoformat. A dash can be
 specified to read from standard input.
--- a/content/code-security/codeql-cli/codeql-cli-manual/query-run.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/query-run.md
@@ -49,7 +49,7 @@ To run multiple queries in parallel, see [codeql database run-queries](/code-sec

 ## Primary options

-#### `<file.ql>`
+#### `<file.ql>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] QL source of the query to execute.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-database.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-database.md
@@ -34,7 +34,7 @@ codeql resolve database <options>... -- <database>

 ## Primary options

-#### `<database>`
+#### `<database>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The database for which to load the metadata.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-extensions-by-pack.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-extensions-by-pack.md
@@ -42,7 +42,7 @@ Available since `v2.13.3`.

 ## Primary options

-#### `<pack>...`
+#### `<pack>...` <!-- markdownlint-disable-line heading-increment -->

 The path to the root of the packs to resolve extensions for.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-extensions.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-extensions.md
@@ -41,7 +41,7 @@ specifiers passed in as command line arguments.

 ## Primary options

-#### `<querysuite|pack>...`
+#### `<querysuite|pack>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Queries to execute. Each argument is in the form
 `scope/name@range:path` where:
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-extractor.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-extractor.md
@@ -37,7 +37,7 @@ language.

 ## Primary options

-#### `-l, --language=<lang>`
+#### `-l, --language=<lang>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The name of the extractor to locate.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-files.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-files.md
@@ -50,7 +50,7 @@ patterns, which can use the following wildcard characters:

 ## Primary options

-#### `<dir>`
+#### `<dir>` <!-- markdownlint-disable-line heading-increment -->

 The directory to be searched.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-languages.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-languages.md
@@ -40,7 +40,7 @@ format an appropriate error message.

 ## Primary options

-#### `--search-path=<dir>[:<dir>...]`
+#### `--search-path=<dir>[:<dir>...]` <!-- markdownlint-disable-line heading-increment -->

 A list of directories under which extractor packs may be found. The
 directories can either be the extractor packs themselves or directories
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-library-path.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-library-path.md
@@ -48,7 +48,7 @@ change without much notice as the QL language ecosystem evolves.**

 ## Primary options

-#### `--[no-]find-extractors`
+#### `--[no-]find-extractors` <!-- markdownlint-disable-line heading-increment -->

 \[Advanced] Include in the output a summary of `extractor` fields from
 the QL packs that the query depends on. This is used only for a few rare
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-metadata.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-metadata.md
@@ -37,7 +37,7 @@ query source file.

 ## Primary options

-#### `<file>`
+#### `<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Query source file from which to extract metadata.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-ml-models.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-ml-models.md
@@ -43,7 +43,7 @@ This command is deprecated. Use [codeql resolve extensions](/code-security/codeq

 ## Primary options

-#### `<querysuite|pack>...`
+#### `<querysuite|pack>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Queries to execute. Each argument is in the form
 `scope/name@range:path` where:
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-qlpacks.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-qlpacks.md
@@ -43,7 +43,7 @@ an error message.

 ## Primary options

-#### `--search-path=<dir>[:<dir>...]`
+#### `--search-path=<dir>[:<dir>...]` <!-- markdownlint-disable-line heading-increment -->

 A list of directories under which QL packs may be found. Each directory
 can either be a QL pack (or bundle of packs containing a
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-qlref.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-qlref.md
@@ -36,7 +36,7 @@ Accepts a .qlref file and returns the .ql file that it points to.

 ## Primary options

-#### `<qlref>`
+#### `<qlref>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] .qlref file to dereference.

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-queries.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-queries.md
@@ -43,7 +43,7 @@ list of queries.

 ## Primary options

-#### `<querysuite|pack>...`
+#### `<querysuite|pack>...` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] Queries to execute. Each argument is in the form
 `scope/name@range:path` where:
--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-ram.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-ram.md
@@ -43,7 +43,7 @@ desired _total_ RAM amount.

 ## Primary options

-#### `--format=<fmt>`
+#### `--format=<fmt>` <!-- markdownlint-disable-line heading-increment -->

 Select output format. Choices include:

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-tests.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-tests.md
@@ -38,7 +38,7 @@ individual .ql and .qlref files to execute.

 ## Primary options

-#### `<test|dir>...`
+#### `<test|dir>...` <!-- markdownlint-disable-line heading-increment -->

 Each argument is one of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/resolve-upgrades.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/resolve-upgrades.md
@@ -41,7 +41,7 @@ in extraordinary cases where exact control is needed.

 ## Primary options

-#### `--dbscheme=<file>`
+#### `--dbscheme=<file>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The _current_ dbscheme of the dataset we want to upgrade.

--- a/content/code-security/codeql-cli/codeql-cli-manual/test-accept.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/test-accept.md
@@ -46,7 +46,7 @@ results of _failing_ tests from a previous run.

 ## Primary options

-#### `<test|dir>...`
+#### `<test|dir>...` <!-- markdownlint-disable-line heading-increment -->

 Each argument is one of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/test-extract.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/test-extract.md
@@ -38,7 +38,7 @@ execute test queries against.

 ## Primary options

-#### `<testDir>`
+#### `<testDir>` <!-- markdownlint-disable-line heading-increment -->

 \[Mandatory] The path to the test directory.

--- a/content/code-security/codeql-cli/codeql-cli-manual/test-run.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/test-run.md
@@ -34,7 +34,7 @@ Run unit tests for QL queries.

 ## Primary options

-#### `<test|dir>...`
+#### `<test|dir>...` <!-- markdownlint-disable-line heading-increment -->

 Each argument is one of:

--- a/content/code-security/codeql-cli/codeql-cli-manual/version.md
+++ b/content/code-security/codeql-cli/codeql-cli-manual/version.md
@@ -34,7 +34,7 @@ Show the version of the CodeQL toolchain.

 ## Primary options

-#### `--format=<fmt>`
+#### `--format=<fmt>` <!-- markdownlint-disable-line heading-increment -->

 Select output format. Choices include `text` _(default)_ ,`terse`, and
 `json`.