· 全部指南
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 可讀性。