From 24e0894840c6b40fe915534db19cf2b4395461f5 Mon Sep 17 00:00:00 2001
From: Justin Mayer <entroP@gmail.com>
Date: Fri, 17 Oct 2025 09:36:12 +0200
Subject: [PATCH] docs: Avoid using colons in metadata field names

Fix #3486
---
 docs/faq.rst | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/faq.rst b/docs/faq.rst
index dc6097c8..3c2ac972 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -112,6 +112,11 @@ If you want to include metadata in templates outside the article context (e.g.,
 
     {% if article and article.modified %}
 
+.. note::
+
+    Because the colon symbol (``:``) is used as a separator, be aware that
+    metadata field names *containing* a colon will probably not work.
+
 How do I make my output folder structure identical to my content hierarchy?
 ===========================================================================