diff --git a/.markdownlint.json b/.markdownlint.json
index 1ad75f229f47f07b96229f30c4fcf2aa68329f33..ddf5105d7f27f2f8773e41498c5850e360f4c854 100644
--- a/.markdownlint.json
+++ b/.markdownlint.json
@@ -116,6 +116,7 @@
       "SMTP",
       "SSH",
       "Tiller",
+      "TOML",
       "Trello",
       "Trello Power-Ups",
       "TypeScript",
@@ -125,6 +126,7 @@
       "Unicorn",
       "unicorn-worker-killer",
       "WebdriverIO",
+      "YAML",
       "YouTrack"
     ],
     "code_blocks": false
diff --git a/doc/ci/large_repositories/index.md b/doc/ci/large_repositories/index.md
index 6ac3fa2c92d6fa132f3fcd2b6677aefee02ff682..b4059fc252bb4473e9b5178600b26e94295758ba 100644
--- a/doc/ci/large_repositories/index.md
+++ b/doc/ci/large_repositories/index.md
@@ -130,7 +130,7 @@ other using `docker` executor.
 
 ### `shell` executor example
 
-Let's assume that you have the following [config.toml](https://docs.gitlab.com/runner/configuration/advanced-configuration.html).
+Let's assume that you have the following [`config.toml`](https://docs.gitlab.com/runner/configuration/advanced-configuration.html).
 
 ```toml
 concurrent = 4
@@ -155,7 +155,7 @@ This `config.toml`:
 
 ### `docker` executor example
 
-Let's assume that you have the following [config.toml](https://docs.gitlab.com/runner/configuration/advanced-configuration.html).
+Let's assume that you have the following [`config.toml`](https://docs.gitlab.com/runner/configuration/advanced-configuration.html).
 
 ```toml
 concurrent = 4
@@ -216,7 +216,7 @@ but this brings administrative overhead as the `.gitlab-ci.yml` needs to be upda
 In such cases, it might be desirable to keep the `.gitlab-ci.yml` clone path agnostic, but make it
 a configuration of Runner.
 
-We can extend our [config.toml](https://docs.gitlab.com/runner/configuration/advanced-configuration.html)
+We can extend our [`config.toml`](https://docs.gitlab.com/runner/configuration/advanced-configuration.html)
 with the following specification that will be used by Runner if `.gitlab-ci.yml` will not override it:
 
 ```toml
diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md
index e478234df1d91a57ec20e88616fe4c00c7e03101..34ec8c097088d966c785f491961b1370b2cb5eb0 100644
--- a/doc/development/documentation/styleguide.md
+++ b/doc/development/documentation/styleguide.md
@@ -1008,7 +1008,7 @@ of language classes available.
 | `ruby`                  | Alias: `rb`.                                                                 |
 | `shell`                 | Aliases: `bash` or `sh`.                                                     |
 | `sql`                   |                                                                              |
-| `toml`                  | Runner configuration examples, and other toml formatted configuration files. |
+| `toml`                  | Runner configuration examples, and other TOML-formatted configuration files. |
 | `typescript`            | Alias: `ts`.                                                                 |
 | `xml`                   |                                                                              |
 | `yaml`                  | Alias: `yml`.                                                                |