diff --git a/rc/asciidoc.kak b/rc/asciidoc.kak
index 331681921..af7e42e5e 100644
--- a/rc/asciidoc.kak
+++ b/rc/asciidoc.kak
@@ -1,17 +1,32 @@
+# http://asciidoc.org/
+# ‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾‾
+
+# Detection
+# ‾‾‾‾‾‾‾‾‾
+
 hook global BufCreate .*\.asciidoc %{ set buffer filetype asciidoc }
 
-addhl -group / group asciidoc
-addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n={2,}\h*\n\h*$ 0:blue
-addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n-{2,}\h*\n\h*$ 0:cyan
-addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n~{2,}\h*\n\h*$ 0:green
-addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n\^{2,}\h*\n\h*$ 0:yellow
-addhl -group /asciidoc regex ^\h+([-\*])\h+[^\n]*(\n\h+[^-\*]\S+[^\n]*)*$ 0:yellow 1:cyan
-addhl -group /asciidoc regex ^([-=~]+)\n[^\n\h].*?\n\1$ 0:magenta
-addhl -group /asciidoc regex (?<!\w)\+[^\n]+?\+(?!\w) 0:green
-addhl -group /asciidoc regex (?<!\w)_[^\n]+?_(?!\w) 0:yellow
-addhl -group /asciidoc regex (?<!\w)\*[^\n]+?\*(?!\w) 0:red
-addhl -group /asciidoc regex ^:[-\w]+: 0:blue
+# Highlighters
+# ‾‾‾‾‾‾‾‾‾‾‾‾
 
+addhl -group / group asciidoc
+
+addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n={2,}\h*\n\h*$ 0:title
+addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n-{2,}\h*\n\h*$ 0:header
+addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n~{2,}\h*\n\h*$ 0:header
+addhl -group /asciidoc regex (\A|\n\n)[^\n]+\n\^{2,}\h*\n\h*$ 0:header
+addhl -group /asciidoc regex ^\h+([-\*])\h+[^\n]*(\n\h+[^-\*]\S+[^\n]*)*$ 0:list 1:bullet
+addhl -group /asciidoc regex ^([-=~]+)\n[^\n\h].*?\n\1$ 0:block
+addhl -group /asciidoc regex (?<!\w)\+[^\n]+?\+(?!\w) 0:mono
+addhl -group /asciidoc regex (?<!\w)_[^\n]+?_(?!\w) 0:italic
+addhl -group /asciidoc regex (?<!\w)\*[^\n]+?\*(?!\w) 0:bold
+addhl -group /asciidoc regex ^:[-\w]+: 0:meta
+
+# Commands
+# ‾‾‾‾‾‾‾‾
+
+# Initialization
+# ‾‾‾‾‾‾‾‾‾‾‾‾‾‾
+#
 hook global WinSetOption filetype=asciidoc %{ addhl ref asciidoc }
 hook global WinSetOption filetype=(?!asciidoc).* %{ rmhl asciidoc }
-
diff --git a/rc/markdown.kak b/rc/markdown.kak
index 88573c50a..3aaffab7b 100644
--- a/rc/markdown.kak
+++ b/rc/markdown.kak
@@ -30,18 +30,18 @@ addhl -group /markdown/fish ref fish
 addhl -group /markdown/ruby ref ruby
 
 # Setext-style header
-addhl -group /markdown/content regex (\A|\n\n)[^\n]+\n={2,}\h*\n\h*$ 0:blue
-addhl -group /markdown/content regex (\A|\n\n)[^\n]+\n-{2,}\h*\n\h*$ 0:cyan
+addhl -group /markdown/content regex (\A|\n\n)[^\n]+\n={2,}\h*\n\h*$ 0:title
+addhl -group /markdown/content regex (\A|\n\n)[^\n]+\n-{2,}\h*\n\h*$ 0:header
 
 # Atx-style header
-addhl -group /markdown/content regex ^(#+)(\h+)([^\n]+) 1:red
+addhl -group /markdown/content regex ^(#+)(\h+)([^\n]+) 1:header
 
-addhl -group /markdown/content regex ^\h+([-\*])\h+[^\n]*(\n\h+[^-\*]\S+[^\n]*)*$ 0:yellow 1:cyan
-addhl -group /markdown/content regex ^([-=~]+)\n[^\n\h].*?\n\1$ 0:magenta
-addhl -group /markdown/content regex (?<!\w)\+[^\n]+?\+(?!\w) 0:green
-addhl -group /markdown/content regex (?<!\w)_[^\n]+?_(?!\w) 0:yellow
-addhl -group /markdown/content regex (?<!\w)\*[^\n]+?\*(?!\w) 0:red
-addhl -group /markdown/content regex <[a-z]+://.*?> 0:cyan
+addhl -group /markdown/content regex ^\h+([-\*])\h+[^\n]*(\n\h+[^-\*]\S+[^\n]*)*$ 0:list 1:bullet
+addhl -group /markdown/content regex ^([-=~]+)\n[^\n\h].*?\n\1$ 0:block
+addhl -group /markdown/content regex (?<!\w)\+[^\n]+?\+(?!\w) 0:mono
+addhl -group /markdown/content regex (?<!\w)_[^\n]+?_(?!\w) 0:italic
+addhl -group /markdown/content regex (?<!\w)\*[^\n]+?\*(?!\w) 0:bold
+addhl -group /markdown/content regex <[a-z]+://.*?> 0:link
 addhl -group /markdown/content regex ^\h*(>\h*)+ 0:comment
 addhl -group /markdown/content regex \H\K\h\h$ 0:PrimarySelection
 
diff --git a/share/kak/kakrc b/share/kak/kakrc
index 2e93a9259..7acb21cf7 100644
--- a/share/kak/kakrc
+++ b/share/kak/kakrc
@@ -1,4 +1,6 @@
 # define color scheme
+#
+# For Code
 face value red
 face type yellow
 face identifier green
@@ -10,6 +12,18 @@ face attribute green
 face comment cyan
 face meta magenta
 
+# For markup
+face title blue
+face header cyan
+face bold red
+face italic yellow
+face mono green
+face block magenta
+face meta blue
+face link cyan
+face bullet cyan
+face list yellow
+
 def -shell-params runtime %{ %sh{
         while [ $# -gt 0 ]; do
             echo "source '${kak_runtime}/$1'"