diff --git a/packages/framework/src/Markdown/Processing/HeadingRenderer.php b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
index 40fdbbffbc3..29e03175d9c 100644
--- a/packages/framework/src/Markdown/Processing/HeadingRenderer.php
+++ b/packages/framework/src/Markdown/Processing/HeadingRenderer.php
@@ -14,6 +14,8 @@
  * Renders a heading node, and supports built-in permalink generation.
  *
  * @see \League\CommonMark\Extension\CommonMark\Renderer\Block\HeadingRenderer
+ *
+ * @todo Add more options to customize the permalink.
  */
 class HeadingRenderer implements NodeRendererInterface
 {