diff --git a/doc/dev/release-workflow.rst b/doc/dev/release-workflow.rst
index 59daa5ee..c957fd89 100644
--- a/doc/dev/release-workflow.rst
+++ b/doc/dev/release-workflow.rst
@@ -158,7 +158,7 @@ anything.
 For all releases, a new section of the following form should be created below
 the ``Unreleased`` section:
 
-.. code-block::
+.. code-block:: md
 
   ## [X.Y.Z] - YYYY-MM-DD
 
@@ -166,7 +166,7 @@ In addition, the reference link for the release should be added and the
 reference link for the unreleased section should be updated at the bottom of the
 document:
 
-.. code-block::
+.. code-block:: md
 
   [Unreleased]: https://github.com/polybar/polybar/compare/X.Y.Z...HEAD
   [X.Y.Z]: https://github.com/polybar/polybar/releases/tag/X.Y.Z