diff --git a/docs/src/content/howto-transparent.md b/docs/src/content/howto-transparent.md
index 71ebd2934..56e94b9d3 100644
--- a/docs/src/content/howto-transparent.md
+++ b/docs/src/content/howto-transparent.md
@@ -288,7 +288,7 @@ sudo -u nobody mitmproxy --mode transparent --showhost
 
 {{% note %}}
 This feature is currently unavailable in mitmproxy 7 and above
-(<a href="https://github.com/mitmproxy/mitmproxy/discussions/4914">#4914</a>).
+([#4914](https://github.com/mitmproxy/mitmproxy/discussions/4914)).
 {{% /note %}}
 
 By default mitmproxy will use its own local IP address for its server-side
diff --git a/docs/src/layouts/shortcodes/note.html b/docs/src/layouts/shortcodes/note.html
index f3db72c4b..b7c345112 100644
--- a/docs/src/layouts/shortcodes/note.html
+++ b/docs/src/layouts/shortcodes/note.html
@@ -1 +1 @@
-<div class="notification is-info">{{.Inner}}</div>
+<div class="notification is-info">{{.Inner | markdownify }}</div>