---
# System prepended metadata

title: 以markdown語法撰寫文章

---

## 概述
本文檔描述在互動交流模組中，由於目前使用者發布貼文的內容是單純以純文本儲存，無法顯示段落及加粗字體等功能，因此嘗試改為使用者可以markdown語法或是在word編輯好貼上去格式不會跑掉來撰寫貼文。

## 作法

>以下做法來自AI建議：
想要使用 Markdown 撰寫（儲存 Markdown，前端 render 為 HTML）→ 用 Markdown editor + react-markdown（或 remark/rehype）來 render。貼自 Word 時可把 HTML 轉成 Markdown（turndown）。


所以這個做法後端存的是markdown，雖然前後端render都需要額外一層的解析器才能渲染markdown，但能有效避免XSS
| 項目         | Markdown           | HTML                          |
| ---------- | ------------------ | ----------------------------- |
| **資料結構**   | 純文字                | 富文本（含標籤）                      |
| **可讀性**    | ✅ 高                | ❌ 差                           |
| **安全性**    | ✅ 高（幾乎無 XSS）       | ❌ 需過濾                         |
| **格式保留**   | ⚠️ 基本（粗體、清單、標題）    | ✅ 完整（顏色、表格等）                  |
| **版本控制**   | ✅ 容易 diff          | ❌ 不易比較差異                      |
| **顯示效能**   | ❌ 需解析              | ✅ 直接渲染                        |
| **SEO 相容** | ⚠️ 需轉 HTML         | ✅ 原生                          |
| **編輯器相容性** | ⚠️ Markdown Editor | ✅ 富文本 Editor（CKEditor, Quill） |
| **適用場景**   | 技術部落格、文件系統、筆記平台    | 一般內容網站、CMS、企業後台               |

