diff --git a/README.md b/README.md
index d366632a..52b36cb4 100644
--- a/README.md
+++ b/README.md
@@ -325,6 +325,8 @@ The header has the menu, if any; the page title, if any; the page description, i
 The body has the page content, if any.
 The footer has the copyright notice, if any, and the theme link, if any.
 
+The page title and description can be Markdown. Markup is stripped for HTML titles.
+
 The page date is the publish date, if any; otherwise, it's the creation date.
 
 Bootstrap 5.2.2 CSS and JavaScript and Bootstrap Icons 1.10.2 are loaded from the Bootstrap CDN for every page unless local Bootstrap assets are used instead.