diff --git a/docs/activitypub.7 b/docs/activitypub.7
index ba7211a..1ad468e 100644
--- a/docs/activitypub.7
+++ b/docs/activitypub.7
@@ -71,10 +71,15 @@ strong, em, b, i, s, u, sub, sup, del, tt, small,
 ol, ul, li, dl, dt, dd
 .Ed
 .Pp
-The followin tag attributes are permitted.
+The following tag attributes are permitted.
 .Bd -literal -offset indent
 href, src, alt, colspan, rowspan
 .Ed
+.Pp
+The following class names are used for syntax highlighting code blocks.
+.Bd -literal -offset indent
+kw, bi, st, nm, tp, op, cm, al, dl
+.Ed
 .Ss ACTIVITIES
 The following activities are supported.
 .Bl -tag -width tenletters
diff --git a/docs/honk.5 b/docs/honk.5
index daa5515..b0d4a63 100644
--- a/docs/honk.5
+++ b/docs/honk.5
@@ -39,9 +39,9 @@ A subset of markdown is supported.
 .It code
 Inline `code fragments` with single ticks.
 .Bd -literal
-```
-Large code blocks
-with triple ticks.
+```c
+/* triple tick code blocks support syntax highlighting */
+int main() { return 0; }
 ```
 .Ed
 .It links