為何 Markdown 是 HCL Domino Blog Template 的救贖之道？

對於長期深耕 HCL Domino（原 IBM Domino）生態系的開發者與系統管理員而言，內建的 Blog Template 一直是個讓人愛恨交織的存在。儘管它提供了穩定的資料儲存與 NRPC 複製機制，但在 2026 年的今天，其內容編輯與前端呈現的侷限性已日益顯著。資深技術專家 Daniel Nashed 近期指出，即便到了 2026 年，使用 Domino Blog Template 進行複雜格式排版依然是一場災難，開發者往往需要在提交後反覆修正 HTML/CSS 才能達到理想效果。(blog.nashcom.de)

傳統 Domino Blog Template 的技術瓶頸

Domino Blog Template 的核心問題不在於單純的 CSS 樣式，而在於其後台處理與重寫內容的邏輯。當使用者在 Notes Client 或傳統 Web 介面輸入內容時，系統會對 HTML 進行轉換，而這種轉換往往受限於 Notes 較為陳舊的 HTML/CSS 支援。這導致了以下幾個痛點：

格式跑掉： 複雜的程式碼區塊、表格或巢狀清單在儲存後經常變形。
維護困難： 若要徹底修正模板邏輯，需要對大量的 LotusScript 或 Java 代理程式進行重構，成本極高。
現代化脫節： 難以直接整合現代前端框架（如 Tailwind CSS 或 SvelteKit），使得介面顯得過時。

然而，許多企業與專家並不希望遷移平台，因為 Domino 資料庫中累積了數十年的技術知識與歷史資料，且其強大的複製與權限管理功能在企業內網環境中仍具備極高價值。(blog.nashcom.de)

Markdown：作為內容與呈現的橋樑

面對上述困境，「Markdown」成為了一種低成本且高效的解決方案。與其掙扎於 Domino 內建的 Rich Text 轉換邏輯，不如將 Domino 定位為「Headless CMS」或純粹的資料儲存層，而內容則改用 Markdown 撰寫。這種做法在現代 Jamstack 架構中已是標準配備。(configr.medium.com)

引入 Markdown 的核心優勢包括：

寫作體驗一致性： 開發人員可以使用熟悉的語法撰寫技術文章，無需擔心 HTML 標籤被系統惡意過濾或修改。
安全性提升： 透過 Markdown 渲染引擎（如 Marked.js）搭配過濾工具（如 DOMPurify），可以有效防止 XSS 攻擊，確保輸出的 HTML 是經過淨化的。(YouTube: How To Build A Markdown Blog)
前後端分離： Domino 僅負責儲存 Markdown 字串，前端則可利用 Hugo、SvelteKit 或 Eleventy 等現代工具進行靜態生成（SSG），大幅提升載入速度與 SEO 表現。(joshcollinsworth.com)

技術實作思路：從 Domino 到現代前端

若要改造現有的 Domino Blog 環境，可以參考以下技術路徑：

1. 內容儲存層的改造

在 Domino Form 中新增一個名為 Body_Markdown 的純文字欄位（Plain Text），用於存儲原始的 Markdown 內容。這能避開 Domino 對 Rich Text 的自動處理。對於既有的舊文章，可以撰寫簡單的代理程式進行初步轉換，或保留舊格式並僅對新文章啟動 Markdown 模式。

2. 渲染與淨化邏輯

在前端呈現時，可以採用 Node.js 或客戶端 JavaScript 進行渲染。如以下概念程式碼所示：

📂 收合（點我收起）


// 引入 Marked 與 DOMPurify
const marked = require('marked');
const createDomPurify = require('dompurify');
const { JSDOM } = require('jsdom');

const window = new JSDOM('').window;
const DOMPurify = createDomPurify(window);

// 將 Domino 欄位中的 Markdown 轉換為安全的 HTML
const rawMarkdown = dominoDoc.getItemValueString("Body_Markdown");
const cleanHTML = DOMPurify.sanitize(marked.parse(rawMarkdown));

這種模式能確保即便 Markdown 中夾雜了惡意腳本，也會在渲染階段被剔除。(YouTube: How To Build A Markdown Blog)

3. 整合靜態網站生成器 (SSG)

為了達到極致的效能，可以利用 Hugo 或 SvelteKit。這類架構透過 API 或 DXL 將 Domino 內容匯出，並在建構階段生成靜態 HTML 檔案。這不僅解決了 Domino 伺服器 HTTP 堆疊的效能壓力，更讓部落格能部署於 CDN 上，實現全球快速存取。(YouTube: Build the Fastest Blog Website)

結論：保留核心，進化外殼

Daniel Nashed 的思考反映了許多 Domino 老兵的心聲：我們不需要拋棄 Domino 的穩定性，但我們必須拋棄它過時的內容處理方式。將 Markdown 引入 Domino Blog 模板，不僅是為了解決格式混亂的問題，更是為了讓這套經典的系統能夠與現代 Web 開發生態接軌。透過「Markdown 儲存 + 現代前端渲染」的混合架構，Domino 將不再是技術分享的障礙，而是強大的後盾。