diff --git a/docs/descriptors/json_eslint_plugin_jsonc.md b/docs/descriptors/json_eslint_plugin_jsonc.md
index ea63a3387c5..c3280709bd0 100644
--- a/docs/descriptors/json_eslint_plugin_jsonc.md
+++ b/docs/descriptors/json_eslint_plugin_jsonc.md
@@ -15,7 +15,7 @@ description: How to use eslint-plugin-jsonc (configure, ignore files, ignore err
 
 _This linter has been disabled in this version_
 
-_Disabled reason: Bug in eslint-plugin-jsonc: https://github.com/ota-meshi/eslint-plugin-jsonc/issues/328_
+_Disabled reason: Bug in eslint-plugin-jsonc: <https://github.com/ota-meshi/eslint-plugin-jsonc/issues/328>_
 
 **eslint-plugin-jsonc** uses eslint to lint [**json**](https://www.json.org/), [**jsonc**](https://github.com/microsoft/node-jsonc-parser) and [**json5**](https://json5.org/) (extended JSON with comments & more).
 
diff --git a/docs/descriptors/makefile_checkmake.md b/docs/descriptors/makefile_checkmake.md
index ad2f8515d86..df7ff1cae90 100644
--- a/docs/descriptors/makefile_checkmake.md
+++ b/docs/descriptors/makefile_checkmake.md
@@ -9,7 +9,7 @@ description: How to use checkmake (configure, ignore files, ignore errors, help
 
 _This linter has been disabled in this version_
 
-_Disabled reason: Security issues: https://github.com/mrtazz/checkmake/issues/99_
+_Disabled reason: Security issues: <https://github.com/mrtazz/checkmake/issues/99>_
 
 ## checkmake documentation
 
diff --git a/docs/descriptors/markdown_remark_lint.md b/docs/descriptors/markdown_remark_lint.md
index ada4938b885..0b82676202b 100644
--- a/docs/descriptors/markdown_remark_lint.md
+++ b/docs/descriptors/markdown_remark_lint.md
@@ -9,7 +9,7 @@ description: How to use remark-lint (configure, ignore files, ignore errors, hel
 
 _This linter has been disabled in this version_
 
-_Disabled reason: Bug in remark-lint: https://github.com/remarkjs/remark-lint/issues/322_
+_Disabled reason: Bug in remark-lint: <https://github.com/remarkjs/remark-lint/issues/322>_
 
 ## remark-lint documentation
 
diff --git a/docs/descriptors/xml_xmllint.md b/docs/descriptors/xml_xmllint.md
index b8b67a0113e..85fe8ecfca1 100644
--- a/docs/descriptors/xml_xmllint.md
+++ b/docs/descriptors/xml_xmllint.md
@@ -25,7 +25,7 @@ To apply file formatting you must set `XML_XMLLINT_CLI_LINT_MODE: file` and `XML
 | Variable                                | Description                                                                                                                                                                                                         | Default value      |
 |-----------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------|
 | XML_XMLLINT_AUTOFORMAT                  | If set to `true`, it will reformat and reindent the output                                                                                                                                                          | `false`            |
-| XML_XMLLINT_INDENT                      | The number of indentation spaces when `XML_XMLLINT_AUTOFORMAT` is `true`                                                                                                                                            | `  `               |
+| XML_XMLLINT_INDENT                      | The number of indentation spaces when `XML_XMLLINT_AUTOFORMAT` is `true`                                                                                                                                            | ``                 |
 | XML_XMLLINT_ARGUMENTS                   | User custom arguments to add in linter CLI call<br/>Ex: `-s --foo "bar"`                                                                                                                                            |                    |
 | XML_XMLLINT_COMMAND_REMOVE_ARGUMENTS    | User custom arguments to remove from command line before calling the linter<br/>Ex: `-s --foo "bar"`                                                                                                                |                    |
 | XML_XMLLINT_FILTER_REGEX_INCLUDE        | Custom regex including filter<br/>Ex: `(src\|lib)`                                                                                                                                                                  | Include every file |