From 507b4e5722ecfde21c42cc4e6502b0049e3ef192 Mon Sep 17 00:00:00 2001
From: Vladislav Doster <mvdoster@gmail.com>
Date: Mon, 2 Feb 2026 10:50:22 -0600
Subject: [PATCH] fix: add markdownlint exceptions to linting

Disabled following checks:

- MD024/no-duplicate-heading
- MD059/descriptive-link-text
- MD060/table-column-style

Signed-off-by: Vladislav Doster <mvdoster@gmail.com>
---
 .github/workflows/linting.yaml | 18 +++++----
 README.md                      |  8 ++--
 doc/HACKING.md                 | 74 +++++++++++++++++-----------------
 3 files changed, 51 insertions(+), 49 deletions(-)

diff --git a/.github/workflows/linting.yaml b/.github/workflows/linting.yaml
index 66b0758d..4820e4df 100644
--- a/.github/workflows/linting.yaml
+++ b/.github/workflows/linting.yaml
@@ -19,13 +19,15 @@ jobs:
       - uses: xt0rted/markdownlint-problem-matcher@v3
 
       - run: npm install -g markdownlint-cli
-
       # disabled checks:
-      # - MD013/line-length
-      # - MD033/no-inline-html
-      # - MD034/no-bare-urls
-      # - MD036/no-emphasis-as-heading
-      # - MD041/first-line-heading/first-line-h1
+      # MD013/line-length
+      # MD024/no-duplicate-heading
+      # MD033/no-inline-html
+      # MD034/no-bare-urls
+      # MD036/no-emphasis-as-heading
+      # MD041/first-line-heading/first-line-h1
+      # MD059/descriptive-link-text
+      # MD060/table-column-style
       - run: |
           markdownlint --version
 
@@ -33,9 +35,9 @@ jobs:
           ls *.md **/*.md
 
           markdownlint \
+            --disable MD013 MD024 MD029 MD033 MD034 MD036 MD041 MD059 MD060 \
             --ignore '**/CHANGELOG.md' \
-            --disable MD013 MD033 MD034 MD036 MD041 -- \
-            *.md **/*.md
+            -- *.md **/*.md
 
   zshlint:
     name: ZSH Lint
diff --git a/README.md b/README.md
index 479b1d5a..11798785 100644
--- a/README.md
+++ b/README.md
@@ -677,9 +677,9 @@ # make'!...' -> run make before atclone & atpull
 You can also check out the [Gallery of Zinit Invocations](https://zdharma-continuum.github.io/zinit/wiki/GALLERY/) for
 some additional examples.
 
-Also, two articles on the Wiki present an example setup
-[here](https://zdharma-continuum.github.io/zinit/wiki/Example-Minimal-Setup/) and
-[here](https://zdharma-continuum.github.io/zinit/wiki/Example-Oh-My-Zsh-setup/).
+Also, two articles on the Wiki present a
+[Minimal Setup](https://zdharma-continuum.github.io/zinit/wiki/Example-Minimal-Setup/) and
+[Oh-My-Zsh Setup](https://zdharma-continuum.github.io/zinit/wiki/Example-Oh-My-Zsh-setup/).
 
 # How to Use<a name="how-to-use"></a>
 
@@ -1058,7 +1058,7 @@ #### NixOS<a name="disabling-system-wide-compinit-call-nixos"></a>
 On NixOS, the global `compinit` call can be disabled system-wide by setting the following option in your
 `/etc/nixos/configuration.nix`:
 
-```
+```nix
 # Disable global completion init to speed up `compinit` call in `~/.zshrc`.
 programs.zsh.enableGlobalCompInit = false;
 ```
diff --git a/doc/HACKING.md b/doc/HACKING.md
index a5f5d901..46db75ee 100644
--- a/doc/HACKING.md
+++ b/doc/HACKING.md
@@ -63,51 +63,51 @@ ## Testing
 
 1. Install [zunit](https://zunit.xyz) and [revolver](https://github.com/molovo/revolver):
 
-    ```zsh
-    zinit for \
-        as"program" \
-        atclone"ln -sfv revolver.zsh-completion _revolver" \
-        atpull"%atclone" \
-        pick"revolver" \
-      @molovo/revolver \
-        as"completion" \
-        atclone"./build.zsh; ln -sfv zunit.zsh-completion _zunit" \
-        atpull"%atclone" \
-        sbin"zunit" \
-      @zunit-zsh/zunit
-    ```
+```zsh
+zinit for \
+    as"program" \
+    atclone"ln -sfv revolver.zsh-completion _revolver" \
+    atpull"%atclone" \
+    pick"revolver" \
+  @molovo/revolver \
+    as"completion" \
+    atclone"./build.zsh; ln -sfv zunit.zsh-completion _zunit" \
+    atpull"%atclone" \
+    sbin"zunit" \
+  @zunit-zsh/zunit
+```
 
 2. Create a new `.zunit` file in the `tests/` dir. Here's a template:
 
-    ```zsh
-    #!/usr/bin/env zunit
+```zsh
+#!/usr/bin/env zunit
 
-    @setup {
-      load setup
-      setup
-    }
+@setup {
+  load setup
+  setup
+}
 
-    @teardown {
-      load teardown
-      teardown
-    }
+@teardown {
+  load teardown
+  teardown
+}
 
-    @test 'zinit-annex-bin-gem-node installation' {
-      # This spawns the official zinit container and executes a single zinit command
-      # inside it
-      run ./scripts/docker-run.sh --wrap --debug --zunit \
-        zinit light as"null" for zdharma-continuum/null
+@test 'zinit-annex-bin-gem-node installation' {
+  # This spawns the official zinit container and executes a single zinit command
+  # inside it
+  run ./scripts/docker-run.sh --wrap --debug --zunit \
+    zinit light as"null" for zdharma-continuum/null
 
-      # Verify the exit code of the command above
-      assert $state equals 0
-      assert "$output" contains "Downloading"
+  # Verify the exit code of the command above
+  assert $state equals 0
+  assert "$output" contains "Downloading"
 
-      local artifact="${PLUGINS_DIR}/zdharma-continuum---null/readme.md"
-      # Check if we downloaded the file correctly and if it is readable
-      assert "$artifact" is_file
-      assert "$artifact" is_readable
-    }
-    ```
+  local artifact="${PLUGINS_DIR}/zdharma-continuum---null/readme.md"
+  # Check if we downloaded the file correctly and if it is readable
+  assert "$artifact" is_file
+  assert "$artifact" is_readable
+}
+```
 
 You should, of course, also check out the existing tests ;)