diff --git a/modules/lang/crystal/README.org b/modules/lang/crystal/README.org
index 9b4122da5..eb90ce7f0 100644
--- a/modules/lang/crystal/README.org
+++ b/modules/lang/crystal/README.org
@@ -48,6 +48,12 @@ This module requires:
  🔨 This module has no usage documentation yet. [[doom-contrib-module:][Write some?]]
 #+end_quote
 
+** formatter
+By enabling [[doom-module::editor format]], [[doom-package:apheleia]] will be
+used to format the current buffer.
+
+Enable [[doom-module::editor format +onsave]] to format the buffer on save.
+
 * TODO Configuration
 #+begin_quote
  🔨 This module has no configuration documentation yet. [[doom-contrib-module:][Write some?]]