From cf1b8658ff81cf39b111f73c37045f50062efbff Mon Sep 17 00:00:00 2001
From: Ken Lui <116421546+kenlhlui@users.noreply.github.com>
Date: Fri, 12 Dec 2025 00:08:36 -0500
Subject: [PATCH 1/4] feat: added support for rendering markdown text for
 description (YAML -> UI)

---
 _layouts/minimal_search.html | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/_layouts/minimal_search.html b/_layouts/minimal_search.html
index 536342f..483b7c7 100644
--- a/_layouts/minimal_search.html
+++ b/_layouts/minimal_search.html
@@ -5,6 +5,7 @@
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>{{ page.title }}</title>
+    <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
     <style>
         :root {
             /* Maximum number of cards to display per row on wider screens */
@@ -1205,11 +1206,12 @@ <h3>No guides found</h3>
 
                 // Safely handle description
                 const description = guide.description && guide.description !== 'undefined' && guide.description !== 'null' ? guide.description : '';
+                const descriptionHtml = description ? marked.parse(description) : '';
 
                 return `
                 <div class="guides-card">
                     <h3><a href="${guide.url}" target="_blank">${guide.title}</a></h3>
-                    <p class="guides-description" id="${uniqueId}" data-full-text="${description.replace(/"/g, '&quot;')}">${description}</p>
+                    <div class="guides-description" id="${uniqueId}" data-full-text="${description.replace(/"/g, '&quot;')}">${descriptionHtml}</div>
                     <button class="read-more-btn" id="btn-${uniqueId}" onclick="toggleDescription('${uniqueId}', this)" style="display: none;">Read more</button>
                     <div class="guides-tags">
                         ${techniques.map(cat => `<span class="tag technique${activeFilters.technique.has(cat) ? ' active' : ''}" data-facet="technique" data-value="${cat}">${cat}</span>`).join('')}

From f0dcc855090bcbff1fde97d3d690767fac3feffe Mon Sep 17 00:00:00 2001
From: Ken Lui <116421546+kenlhlui@users.noreply.github.com>
Date: Fri, 12 Dec 2025 00:10:43 -0500
Subject: [PATCH 2/4] feat: added support for highlighting links/email.

---
 _layouts/minimal_search.html | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/_layouts/minimal_search.html b/_layouts/minimal_search.html
index 483b7c7..0d523e4 100644
--- a/_layouts/minimal_search.html
+++ b/_layouts/minimal_search.html
@@ -412,6 +412,16 @@
             max-height: none;
         }
 
+        .guides-description a {
+            color: #0066cc;
+            text-decoration: underline;
+        }
+
+        .guides-description a:hover {
+            color: #004499;
+            text-decoration: underline;
+        }
+
         .read-more-btn {
             background: none;
             border: none;

From 89035a3a1f9810fdaf5e5ce9fb082ff7a457d424 Mon Sep 17 00:00:00 2001
From: Ken Lui <116421546+kenlhlui@users.noreply.github.com>
Date: Fri, 12 Dec 2025 00:14:13 -0500
Subject: [PATCH 3/4] feat: update README to clarify markdown support in
 description field

---
 docs/update-data/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/update-data/README.md b/docs/update-data/README.md
index 18e6486..d45d130 100644
--- a/docs/update-data/README.md
+++ b/docs/update-data/README.md
@@ -6,7 +6,7 @@ Each tutorial entry can have the following fields:
 |----------------|------------|----------------------------------------------------------------------------------------------------------------|-----------------------------|
 | `id`           | No         | A unique identifier for the tutorial.                                                                         | String                     |
 | `title`        | Yes        | The title of the tutorial.                                                                                    | String                     |
-| `description`  | No         | A brief description of the tutorial.                                                                          | String                     |
+| `description`  | No         | A brief description of the tutorial. <br><br>**Note**: Markdown is supported when rendering this field.               | String                     |
 | `url`          | Yes        | The URL of the tutorial.                                                                                      | String (URL)                |
 | `technique`    | No         | The technique(s) covered in the tutorial.                                                                     | String or Array of Strings  |
 | `tool`         | No         | The tool(s) used in the tutorial.                                                                             | String or Array of Strings  |

From 5a15b15a1fa4b349d63e5da4a62ae6a3960e4991 Mon Sep 17 00:00:00 2001
From: Ken Lui <116421546+kenlhlui@users.noreply.github.com>
Date: Fri, 12 Dec 2025 00:14:27 -0500
Subject: [PATCH 4/4] docs: update the README for editing YAML file

---
 docs/update-data/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/update-data/README.md b/docs/update-data/README.md
index d45d130..7834421 100644
--- a/docs/update-data/README.md
+++ b/docs/update-data/README.md
@@ -6,7 +6,7 @@ Each tutorial entry can have the following fields:
 |----------------|------------|----------------------------------------------------------------------------------------------------------------|-----------------------------|
 | `id`           | No         | A unique identifier for the tutorial.                                                                         | String                     |
 | `title`        | Yes        | The title of the tutorial.                                                                                    | String                     |
-| `description`  | No         | A brief description of the tutorial. <br><br>**Note**: Markdown is supported when rendering this field.               | String                     |
+| `description`  | No         | A brief description of the tutorial. <br><br>**Note**: Markdown is supported when rendering this field in the web interface.               | String                     |
 | `url`          | Yes        | The URL of the tutorial.                                                                                      | String (URL)                |
 | `technique`    | No         | The technique(s) covered in the tutorial.                                                                     | String or Array of Strings  |
 | `tool`         | No         | The tool(s) used in the tutorial.                                                                             | String or Array of Strings  |