diff --git a/README.md b/README.md
index ec98da682..f3c8934c8 100644
--- a/README.md
+++ b/README.md
@@ -24,24 +24,24 @@ https://user-images.githubusercontent.com/3120367/206125010-bd1fea8e-248a-43e7-8
 # Table of Contents
 
 <!-- toc -->
-- <a href="#what-does-d2-look-like" id="toc-what-does-d2-look-like">What does D2 look like?</a>
-- <a href="#quickstart" id="toc-quickstart">Quickstart</a>
-- <a href="#install" id="toc-install">Install</a>
-- <a href="#d2-as-a-library" id="toc-d2-as-a-library">D2 as a library</a>
-- <a href="#themes" id="toc-themes">Themes</a>
-- <a href="#fonts" id="toc-fonts">Fonts</a>
-- <a href="#export-file-types" id="toc-export-file-types">Export file types</a>
-- <a href="#language-tooling" id="toc-language-tooling">Language tooling</a>
-- <a href="#plugins" id="toc-plugins">Plugins</a>
-- <a href="#comparison" id="toc-comparison">Comparison</a>
-- <a href="#contributing" id="toc-contributing">Contributing</a>
-- <a href="#license" id="toc-license">License</a>
-- <a href="#related" id="toc-related">Related</a>
-  - <a href="#official-plugins" id="toc-official-plugins">Official plugins</a>
-  - <a href="#community-plugins" id="toc-community-plugins">Community plugins</a>
-  - <a href="#misc" id="toc-misc">Misc</a>
-- <a href="#faq" id="toc-faq">FAQ</a>
-- <a href="#open-source-projects-documenting-with-d2" id="toc-open-source-projects-documenting-with-d2">Open-source projects documenting with D2</a>
+- [What does D2 look like?](#what-does-d2-look-like)
+- [Quickstart](#quickstart)
+- [Install](#install)
+- [D2 as a library](#d2-as-a-library)
+- [Themes](#themes)
+- [Fonts](#fonts)
+- [Export file types](#export-file-types)
+- [Language tooling](#language-tooling)
+- [Plugins](#plugins)
+- [Comparison](#comparison)
+- [Contributing](#contributing)
+- [License](#license)
+- [Related](#related)
+  - [Official plugins](#official-plugins)
+  - [Community plugins](#community-plugins)
+  - [Misc](#misc)
+- [FAQ](#faq)
+- [Open-source projects documenting with D2](#open-source-projects-documenting-with-d2)
 
 ## What does D2 look like?
 
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
index c074c4235..439c1958b 100644
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -1,14 +1,14 @@
 # Contributing
 
 <!-- toc -->
-- <a href="#welcome" id="toc-welcome">Welcome</a>
-- <a href="#ci" id="toc-ci">CI</a>
-- <a href="#logistics" id="toc-logistics">Logistics</a>
-- <a href="#dev" id="toc-dev">Dev</a>
-  - <a href="#content" id="toc-content">Content</a>
-  - <a href="#tests" id="toc-tests">Tests</a>
-  - <a href="#documentation" id="toc-documentation">Documentation</a>
-  - <a href="#questions" id="toc-questions">Questions</a>
+- [Welcome](#welcome)
+- [CI](#ci)
+- [Logistics](#logistics)
+- [Dev](#dev)
+  - [Content](#content)
+  - [Tests](#tests)
+  - [Documentation](#documentation)
+  - [Questions](#questions)
 
 ## Welcome
 
diff --git a/docs/INSTALL.md b/docs/INSTALL.md
index 8a4f7a090..50c00c6f5 100644
--- a/docs/INSTALL.md
+++ b/docs/INSTALL.md
@@ -3,21 +3,21 @@
 You may install `d2` through any of the following methods.
 
 <!-- toc -->
-- <a href="#installsh" id="toc-installsh">install.sh</a>
-  - <a href="#security" id="toc-security">Security</a>
-- <a href="#macos-homebrew" id="toc-macos-homebrew">macOS (Homebrew)</a>
-- <a href="#linux" id="toc-linux">Linux</a>
-  - <a href="#void-linux" id="toc-void-linux">Void Linux</a>
-- <a href="#standalone" id="toc-standalone">Standalone</a>
-  - <a href="#manual" id="toc-manual">Manual</a>
-  - <a href="#prefix" id="toc-prefix">PREFIX</a>
-- <a href="#from-source" id="toc-from-source">From source</a>
-  - <a href="#source-release" id="toc-source-release">Source Release</a>
-- <a href="#windows" id="toc-windows">Windows</a>
-  - <a href="#release-archives" id="toc-release-archives">Release archives</a>
-  - <a href="#wsl" id="toc-wsl">WSL</a>
-- <a href="#docker" id="toc-docker">Docker</a>
-- <a href="#coming-soon" id="toc-coming-soon">Coming soon</a>
+- [install.sh](#installsh)
+  - [Security](#security)
+- [macOS (Homebrew)](#macos-homebrew)
+- [Linux](#linux)
+  - [Void Linux](#void-linux)
+- [Standalone](#standalone)
+  - [Manual](#manual)
+  - [PREFIX](#prefix)
+- [From source](#from-source)
+  - [Source Release](#source-release)
+- [Windows](#windows)
+  - [Release archives](#release-archives)
+  - [WSL](#wsl)
+- [Docker](#docker)
+- [Coming soon](#coming-soon)
 
 ## install.sh