diff --git a/modules/lang/markdown/config.el b/modules/lang/markdown/config.el
index 63d5bd0f0..450341a70 100644
--- a/modules/lang/markdown/config.el
+++ b/modules/lang/markdown/config.el
@@ -67,9 +67,9 @@ capture, the end position, and the output buffer.")
     fill-nobreak-predicate (cons #'markdown-code-block-at-point-p
                                  fill-nobreak-predicate))
 
-  ;; HACK Prevent mis-fontification of YAML metadata blocks in `markdown-mode'
-  ;;      which occurs when the first line contains a colon in it. See
-  ;;      jrblevin/markdown-mode#328.
+  ;; HACK: Prevent mis-fontification of YAML metadata blocks in `markdown-mode'
+  ;;   which occurs when the first line contains a colon in it. See
+  ;;   jrblevin/markdown-mode#328.
   (defadvice! +markdown-disable-front-matter-fontification-a (&rest _)
     :override #'markdown-match-generic-metadata
     (ignore (goto-char (point-max))))
diff --git a/modules/lang/markdown/doctor.el b/modules/lang/markdown/doctor.el
index 6d7fe28ff..6a2d39231 100644
--- a/modules/lang/markdown/doctor.el
+++ b/modules/lang/markdown/doctor.el
@@ -4,9 +4,9 @@
 (when (require 'markdown-mode nil t)
   (cond ((eq markdown-command #'+markdown-compile)
          (unless (cl-loop for (exe . cmd) in (list (cons "marked" '+markdown-compile-marked)
-                                           (cons "pandoc" '+markdown-compile-pandoc)
-                                           (cons "markdown" '+markdown-compile-markdown)
-                                           (cons "multimarkdown" '+markdown-compile-multimarkdown))
+                                                   (cons "pandoc" '+markdown-compile-pandoc)
+                                                   (cons "markdown" '+markdown-compile-markdown)
+                                                   (cons "multimarkdown" '+markdown-compile-multimarkdown))
                           if (and (memq cmd +markdown-compile-functions)
                                   (executable-find exe))
                           return t)
diff --git a/modules/lang/markdown/packages.el b/modules/lang/markdown/packages.el
index e2a16ddda..347df40cc 100644
--- a/modules/lang/markdown/packages.el
+++ b/modules/lang/markdown/packages.el
@@ -3,6 +3,9 @@
 
 (package! markdown-mode :pin "8aab017f4790f7a1e0d8403239cce989c88412f6")
 (package! markdown-toc :pin "3d724e518a897343b5ede0b976d6fb46c46bcc01")
+
+;; Required by `markdown-mode', or it will install it via package.el if it isn't
+;; present when you call `markdown-edit-code-block'.
 (package! edit-indirect :pin "82a28d8a85277cfe453af464603ea330eae41c05")
 
 (when (modulep! +grip)