---

引言

在多平臺內容分發與管理的場景中，文檔格式轉換已成為內容生態系統中的關鍵環節。Markdown 作為輕量級標記語言，以其語法簡潔、易讀易寫的特性在內容創作領域占據重要地位；而 HTML 作為網頁標準格式，是內容展示與交互的基礎。

本文將分享如何利用國產文檔處理庫 Spire.Doc for Python 實現 Markdown 與 HTML 兩種格式之間的相互互轉，代碼簡潔、適合文檔系統、博客平臺、內容管理工具等場景。

---

與同類工具的優勢對比

相比 pandoc 等通用轉換工具，Spire.Doc for Python 具有以下優勢：

• 無需安裝Microsoft Word或其他辦公軟件即可運行
• 對復雜格式的處理更精準，尤其是表格和圖片
• 轉換速度快，適合批量處理文檔
• 完美支持Windows、Linux和 macOS 系統

pip 安裝命令：

pip install Spire.Doc

（點擊申請免費測試授權）

---

Python 將 Markdown 轉換為 HTML

將 Markdown 文檔轉為 HTML，可用于網頁發布、在線文檔預覽等場景。以下是完整 Python 代碼，包含詳細注釋：

from spire.doc import *# 加載Markdown文檔
doc = Document()
doc.LoadFromFile("示例.md", FileFormat.Markdown)# 將Markdown另存為HTML
doc.SaveToFile("example.html", FileFormat.Html)# 關閉文檔
doc.Close()

代碼簡潔易懂：創建Document對象 → LoadFromFile 加載 Markdown → SaveToFile 保存為HTML → 關閉文檔釋放資源

---

Python 將 HTML 轉換為 Markdown

將 HTML 文件轉為 Markdown，可用于網頁內容存檔、文檔二次編輯等場景。實現邏輯與 Markdown 轉 HTML 對稱，僅需調整文件格式參數。

from spire.doc import *# 加載HTML文件
doc = Document()
doc.LoadFromFile("input.html", FileFormat.Html)# 將HTML另存為Markdown
doc.SaveToFile("output.md", FileFormat.Markdown)# 關閉文檔
doc.Close()

關鍵細節

1. HTML 標簽兼容性：Spire.Doc 支持大多數標準 HTML 標簽的轉換（如 <h1>、<p>、<a>、<img>、<code>），但對于復雜的 CSS樣式，轉換后可能簡化為基礎 Markdown 語法。
2. 圖片與鏈接：若 HTML 中包含本地圖片，轉換為 Markdown 后鏈接路徑會保持不變，需確保目標 Markdown 文件與圖片路徑的相對位置正確。

---

批量轉換與自動化處理

若需處理文件夾中的所有 Markdown 或 HTML 文件，可結合 os 庫遍歷文件：

import os
from spire.doc import *def batch_convert_files(input_dir, output_dir, source_format, target_format):"""批量轉換目錄中的文件參數:input_dir (str): 輸入文件目錄output_dir (str): 輸出文件目錄source_format: 源文件格式 (FileFormat.Markdown 或 FileFormat.Html)target_format: 目標文件格式 (FileFormat.Html 或 FileFormat.Markdown)"""# 創建輸出目錄（如果不存在）if not os.path.exists(output_dir):os.makedirs(output_dir)print(f"創建輸出目錄: {output_dir}")# 獲取源文件擴展名source_ext = ".md" if source_format == FileFormat.Markdown else ".html"# 遍歷輸入目錄for filename in os.listdir(input_dir):# 只處理指定格式的文件if not filename.endswith(source_ext):continue# 構建完整路徑input_path = os.path.join(input_dir, filename)base_name = os.path.splitext(filename)[0]target_ext = ".html" if target_format == FileFormat.Html else ".md"output_path = os.path.join(output_dir, base_name + target_ext)try:# 執行轉換doc = Document()doc.LoadFromFile(input_path, source_format)doc.SaveToFile(output_path, target_format)doc.Close()print(f"已轉換: {filename} -> {base_name}{target_ext}")except Exception as e:print(f"轉換 {filename} 失敗: {str(e)}")# 示例：批量將Markdown轉換為HTML
batch_convert_files(input_dir="markdown_files",output_dir="html_output",source_format=FileFormat.Markdown,target_format=FileFormat.Html
)# 示例：批量將HTML轉換為Markdown
# batch_convert_files(
#     input_dir="html_files",
#     output_dir="markdown_output",
#     source_format=FileFormat.Html,
#     target_format=FileFormat.Markdown
# )

掌握 Spire.Doc for Python 的文檔轉換能力，將極大提升你的內容處理效率，該庫不僅支持Markdown與HTML互轉，還支持轉Word、PDF等多種格式，具體可查看其中文教程合集。