From e66107eb8680885c05a129b1c21184d20830469b Mon Sep 17 00:00:00 2001
From: squidfunk <martin.donath@squidfunk.com>
Date: Wed, 26 Mar 2025 11:59:48 +0100
Subject: [PATCH] Documentation

---
 docs/plugins/tags.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/plugins/tags.md b/docs/plugins/tags.md
index 808ae6578..bd1262e31 100644
--- a/docs/plugins/tags.md
+++ b/docs/plugins/tags.md
@@ -933,3 +933,9 @@ listing entirely:
     ```
 
 If this setting is left empty, no tags or pages are excluded.
+
+## Limitations
+
+The implementation of the tags plugin is tricky due to MkDocs architecture.
+Notably, tag listing markers cannot appear within code blocks. For technical
+details, refer to #8114.