diff --git a/docs/conf.py b/docs/conf.py
index 227cd7d4e2..6773d2d93b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -31,7 +31,7 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    'recommonmark',
+    'myst_parser',
     'sphinx_rtd_theme',
     "sphinx_favicon",
 ]
@@ -70,4 +70,9 @@ def setup(app):
 
 favicons = [
     "favicon.png",
+]
+
+myst_enable_extensions = [
+    "attrs_inline",
+    "colon_fence",
 ]
\ No newline at end of file
diff --git a/docs/reference/changelog.md b/docs/reference/changelog.md
index 3704d85e7a..035bdb9fc6 100644
--- a/docs/reference/changelog.md
+++ b/docs/reference/changelog.md
@@ -1,7 +1,9 @@
 # Changelog
 All notable changes to this project will be documented in this file.
 
-## [1.22.0](https://github.com/sqlc-dev/sqlc/releases/tag/1.22.0)
+
+(v1-22-0)=
+## [1.22.0](https://github.com/sqlc-dev/sqlc/releases/tag/v1.22.0)
 Released 2023-09-26
 
 ### Release notes
@@ -74,7 +76,7 @@ Read more in the [managed databases](../howto/managed-databases.md) documentatio
 - Bump go version to latest in ci workflows (#2722)
 
 
-
+(v1-21-0)=
 ## [1.21.0](https://github.com/sqlc-dev/sqlc/releases/tag/v1.21.0)
 Released 2023-09-06
 
@@ -205,7 +207,7 @@ environment, set to the version of the `sqlc` executable invoking it.
 - (deps) Bump pytz from 2023.3 to 2023.3.post1 in /docs (#2695)
 - (devenv) Bump go from 1.20.7 to 1.21.0 (#2702)
 
-
+(v1-20-0)=
 ## [1.20.0](https://github.com/sqlc-dev/sqlc/releases/tag/v1.20.0)
 Released 2023-07-31
 
diff --git a/docs/requirements.txt b/docs/requirements.txt
index 215c2c144f..16c5d98573 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -8,11 +8,11 @@ idna==3.4
 imagesize==1.4.1
 Jinja2==3.1.2
 MarkupSafe==2.1.3
+myst-parser==2.0.0 
 packaging==23.1
 Pygments==2.16.1
 pyparsing==3.1.1
 pytz==2023.3.post1
-recommonmark==0.7.1
 requests==2.31.0
 snowballstemmer==2.2.0
 Sphinx==6.2.1