From 2c081b488217bc4b32a710e6ce353759ebb37120 Mon Sep 17 00:00:00 2001
From: Kristaps Dz <kristaps@bsd.lv>
Date: Sun, 15 Sep 2024 15:25:14 -0700
Subject: [PATCH] Document code fences.

References #135
---
 man/lowdown.5 | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/man/lowdown.5 b/man/lowdown.5
index 3681378..4ece22f 100644
--- a/man/lowdown.5
+++ b/man/lowdown.5
@@ -365,6 +365,23 @@ Here is how you start the program xterm:
 
     xterm &
 .Ed
+.Pp
+Alternatively, code blocks are called
+.Dq fenced
+if they're surrounded in three or more matching backticks or tildes.
+Code fences may optionally include the language used in the code fence
+following the header, such as in the following.
+.Bd -literal -offset indent
+```c
+int main(void) {
+  puts("Engage!");
+  return 0;
+}
+```
+.Ed
+.Pp
+The language, if provided, is usually passed into the output is
+auxiliary information such as an HTML class.
 .
 .Ss Horizontal Rules
 A horizontal rule is a line that goes across an output page.