From 1bec932730c4b49044519b1c521206e47a77a5fb Mon Sep 17 00:00:00 2001
From: schneekluth <5740913+schneekluth@users.noreply.github.com>
Date: Thu, 12 Mar 2026 13:59:20 +0100
Subject: [PATCH 1/3] Add email link shortcode to layouts

Added E-Mail Shortcode for new E-Mail obfuscation feature introduced in [v2.99.0](]https://github.com/nunocoracao/blowfish/releases/tag/v2.99.0 based on this discussion https://github.com/nunocoracao/blowfish/discussions/2828#discussioncomment-16096521)
---
 layouts/shortcodes/email.html | 8 ++++++++
 1 file changed, 8 insertions(+)
 create mode 100644 layouts/shortcodes/email.html

diff --git a/layouts/shortcodes/email.html b/layouts/shortcodes/email.html
new file mode 100644
index 00000000..83de74cf
--- /dev/null
+++ b/layouts/shortcodes/email.html
@@ -0,0 +1,8 @@
+<a 
+  class="email-link"
+  href="#"
+  data-email="{{ .Get "email" | base64Encode }}"
+  {{ with .Get "subject" }}data-subject="{{ . }}"{{ end }}>
+  {{- .Get "text" -}}
+</a>
+{{- /**/ -}}

From bcdab29c30ba4a8e47faf164aad714e92aba31ab Mon Sep 17 00:00:00 2001
From: schneekluth <5740913+schneekluth@users.noreply.github.com>
Date: Thu, 12 Mar 2026 15:45:49 +0100
Subject: [PATCH 2/3] added snippet for obfuscated email shortcode

---
 .vscode/blowfish.code-snippets | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.vscode/blowfish.code-snippets b/.vscode/blowfish.code-snippets
index abd80369..46c71202 100644
--- a/.vscode/blowfish.code-snippets
+++ b/.vscode/blowfish.code-snippets
@@ -79,7 +79,14 @@
       "{{< /chart >}}"
     ],
     "description": "Use the Chart.js library to embed charts into articles using simple structured data. Blowfish chart Shortcode. Documentation: https://blowfish.page/docs/shortcodes/#chart ",
-  },  
+  },
+  "email": {
+    "prefix": ["BFS-email", "HSC-email", "email"],
+    "body": [
+      "{{< email email=\"mailto:${1:hello@test.com}\" text=\"${2:text}\" subject=\"${3:Reply to awesome article}\" >}}$0",
+    ],
+    "description": "Creates an obfuscated mailto link. Documentation: https://blowfish.page/docs/shortcodes/#email ",
+  },
   "figure": {
     "prefix": ["BFS-figure", "HSC-figure", "figure"],
     "body": [
@@ -255,4 +262,4 @@
     "description": "Typewriter-Like text. Blowfish typeit Shortcode. Documentation: https://blowfish.page/docs/shortcodes/#typeit https://www.typeitjs.com/docs/vanilla/usage/ ",
   },
 
-}
\ No newline at end of file
+}

From 45c9acab9eb3b5805cdafc5b59ebed52e89bde5a Mon Sep 17 00:00:00 2001
From: schneekluth <5740913+schneekluth@users.noreply.github.com>
Date: Thu, 12 Mar 2026 15:48:49 +0100
Subject: [PATCH 3/3] docs updated for obfucated email shortcode

---
 exampleSite/content/docs/shortcodes/index.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/exampleSite/content/docs/shortcodes/index.md b/exampleSite/content/docs/shortcodes/index.md
index 737e3e5d..0bbacdfa 100644
--- a/exampleSite/content/docs/shortcodes/index.md
+++ b/exampleSite/content/docs/shortcodes/index.md
@@ -375,6 +375,18 @@ This shortcode is for importing code from external sources easily without copyin
 
 <br/><br/><br/>
 
+## Email
+
+Creates an obfuscated mailto link:
+
+```md
+{{</* email email="mailto:hello@test.com" text="text" subject="Reply to awesome article" */>}}
+```
+
+{{< email email="mailto:hello@test.com" text="text" subject="Reply to awesome article" >}}
+
+<br/><br/><br/>
+
 ## Figure
 
 Blowfish includes a `figure` shortcode for adding images to content. The shortcode replaces the base Hugo functionality in order to provide additional performance benefits.