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

@@ -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

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;
 ```

doc/HACKING.md

@@ -63,8 +63,8 @@ ## Testing
 
 1. Install [zunit](https://zunit.xyz) and [revolver](https://github.com/molovo/revolver):
 
-    ```zsh
-    zinit for \
+```zsh
+zinit for \
     as"program" \
     atclone"ln -sfv revolver.zsh-completion _revolver" \
     atpull"%atclone" \
@@ -75,24 +75,24 @@ ## Testing
     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 {
+@setup {
   load setup
   setup
-    }
+}
 
-    @teardown {
+@teardown {
   load teardown
   teardown
-    }
+}
 
-    @test 'zinit-annex-bin-gem-node installation' {
+@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 \
@@ -106,8 +106,8 @@ ## Testing
   # 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 ;)