Show HN：SmallDocs – 擺脫煩惱的 Markdown 寫作體驗

背景

SmallDocs 是一款專為 Markdown 檔案設計的 CLI 工具與網頁應用程式，旨在解決開發者與 AI 代理程式互動時，頻繁產生 .md 檔案卻難以優雅預覽與分享的痛點。該工具的核心特色在於隱私保護，透過將文件內容壓縮並編碼後置於 URL 片段中，實現無需伺服器存儲的即時分享。

社群觀點

Hacker News 社群對於 SmallDocs 利用 URL 片段（Fragment）達成隱私分享的技術路徑展現出濃厚興趣。許多討論集中在 URL 長度的物理限制上，開發者 FailMore 指出，雖然不同瀏覽器的上限各異，例如桌面版 Chrome 可達 2MB，但行動版 Safari 僅約 80KB，不過透過該工具約十倍的壓縮率，80KB 仍足以承載相當份量的 Markdown 內容。這種「客戶端網頁」的模式被認為具有極大的潛力，甚至有評論者建議將此技術擴展至 CSV 等其他檔案格式。

然而，URL 過長導致的分享不便也引發了實務上的爭議。有留言者分享了開發類似工具的經驗，提到用戶最終往往會因為網址太長而要求縮網址功能，但這通常意味著必須引入伺服器互動，進而威脅到原本的隱私初衷。針對此點，SmallDocs 隨後提出了一套折衷方案：將加密後的文件存於伺服器，但將解密金鑰保留在 URL 片段中。如此一來，伺服器端僅持有無法解讀的亂碼，而分享者則能獲得較短的網址，同時維持金鑰不落地的隱私特性。

隱私的「可驗證性」是另一個討論焦點。社群成員質疑，即便技術上金鑰不傳回伺服器，但前端 JavaScript 依然有權限讀取片段數據，因此隱私保障在某種程度上仍建立在對開發者的信任之上。對此，開發者曾構思透過 AI 代理程式在每次程式碼合併後進行安全審查並提供驗證標章，但社群普遍認為這類機制仍難以完全消除信任缺口，目前似乎仍受限於瀏覽器架構的先天限制。此外，也有人提醒 SmallDocs 需注意潛在的商標法律風險，因為市場上已有名稱極為相似的商業公司存在。

延伸閱讀

• Easy Analytica HTML Playground：留言者分享的類似技術實作，用於分享 HTML 片段。
• SDocs 隱私短網址實作說明：詳細介紹如何透過客戶端加密與 URL 金鑰分離技術達成短網址功能。
• SmallDocs 公開數據統計：展示該工具的透明化分析數據。