diff --git a/config/_default/markup.toml b/config/_default/markup.toml
index a44f48e..1202e5b 100644
--- a/config/_default/markup.toml
+++ b/config/_default/markup.toml
@@ -1,14 +1,17 @@
 # -- Markup --
 # These settings are required for the theme to function.
 
+# let us put inline html into the markdown files
 [goldmark]
 [goldmark.renderer]
   unsafe = true
 
+# use {.[css-class]} after a paragraph to apply styling
 [goldmark.parser]
 [goldmark.parser.attribute]
   block = true
 
+# let the theme styling apply for code blocks
 [highlight]
   noClasses = false