diff --git a/doc/docgen.py b/doc/docgen.py
index 8d2eaa648..29cefb92e 100644
--- a/doc/docgen.py
+++ b/doc/docgen.py
@@ -648,7 +648,8 @@ class AutogenDoc():
                             '\"/\" for italic, '
                             '\"_\" for underline'
                         )
-                    self.write(f'* [[option_{config}.{section}.{option}]] '
+                    option_esc = option.replace(',', '_')
+                    self.write(f'* [[option_{config}.{section}.{option_esc}]] '
                                f'*{config}.{section}.{option}*')
                     self.write('** %s: pass:none[%s]',
                                _('description'), desc.replace(']', '\\]'))