markdown、html 與純文本:轉換與安全

md↔html 預覽、實體編碼、剝離標籤做摘要,以及避免 xss 的集成要點。

· 全部指南

markdown 在工作流中的位置

readme、文檔站、評論系統常用 markdown。markdown-converter 在 md 與 html 間轉換,便於預覽渲染結果。注意:md 方言(gfm、commonmark)任務列表與表格支持不一。

html 實體與清洗

html-entities 編碼/解碼&等實體,防止 xss 當用戶內容插入 html 時。html-to-text 剝離標籤生成純文本摘要,適合郵件 preview 或搜索索引。切勿 blindly innerhtml 未 sanitize 的用戶 markdown 輸出。

與 cms 集成

存儲層可保留 markdown 源,展示層 compile 為 html 並 cache。代碼塊需指定語言以啟用高亮;連結應 rel="noopener" 當 target=_blank。

towalles 本地優先

轉換在瀏覽器完成,草稿文檔不會上傳。發布前用 text-diff 對比 md 變更,用 readability-scorer 評估面向用戶的 prose 可讀性。

相關工具