Skip to content

Latest commit

 

History

History
75 lines (52 loc) · 4.22 KB

File metadata and controls

75 lines (52 loc) · 4.22 KB

專案概觀 (Project Overview)

📖 什麼是 MD2DOC-Evolution?

MD2DOC-Evolution 是一個專為技術書籍作者工程師專業內容創作者打造的「Markdown 轉 Word (DOCX)」工具。

它的核心目標只有一個:讓作者用最習慣的 Markdown 語法寫作,然後一鍵產出符合出版社專業排版要求的 Word 稿件。

在傳統的出版流程中,技術作者常面臨以下痛點:

  1. 寫作工具斷層:工程師習慣用 VS Code + Markdown 寫作,但出版社編輯通常要求提供 Word 檔以便修訂與排版。
  2. 排版耗時:從 Markdown 複製貼上到 Word 後,程式碼區塊的樣式、圖片大小、標題層級往往全亂,需要花大量時間手工調整。
  3. 缺乏技術元素支援:一般的轉換工具(如 Pandoc)對「程式碼行號」、「Mermaid 圖表」、「對話框」等技術書常見元素支援較差。

MD2DOC-Evolution 正是為了解決這些問題而生。它不是一個通用的格式轉換器,而是一個針對「出版」場景深度客製化的生產力工具。


🎯 核心設計哲學

1. 寫作與排版分離 (Content over Format)

作者應該專注於內容創作,而不是字體大小或行距。本工具透過預設的專業主題(Theme),自動處理所有視覺樣式。

2. 工程師友善 (Developer Friendly)

支援所有工程師喜愛的元素:

  • Mermaid 圖表:直接寫 code 畫流程圖,轉檔自動變圖片。
  • 程式碼區塊:不僅有語法高亮,還能自動加行號、語言標籤。
  • QR Code:連結自動轉二維碼,適應紙本閱讀體驗。

3. 所見即所得 (WYSIWYG)

雖然底層是 Markdown,但我們提供了一個「雙欄預覽」介面。左邊寫作,右邊即時渲染出接近 Word 輸出效果的預覽,確保落版效果符合預期。


🛠️ 詳細功能解讀

1. 專業級排版引擎

  • 中英文字體最佳化:自動將中文字設定為「微軟正黑體 (Microsoft JhengHei)」,英數字與程式碼設定為「Consolas」,符合技術書籍標準。
  • 版面尺寸:支援標準 A4、A5、B5 以及技術書常用的 17x23cm 規格。
  • 自動目錄 (TOC):支援 Word 原生目錄功能,頁碼自動更新。

2. 增強型程式碼處理

技術書的核心在於程式碼展示。本工具提供:

  • 自動行號:可配置開啟/關閉,方便讀者對照程式碼行數。
  • 邊框與底色:清晰區隔程式碼與正文。
  • 語言標記:在區塊右上角自動標示 JavaScriptPython 等語言類型。

3. 圖表與視覺化

  • Mermaid 整合:原生支援 Mermaid.js。在 Markdown 中撰寫的流程圖、時序圖,在匯出時會由瀏覽器渲染為 SVG 並轉存為高解析度 PNG 嵌入 Word,無需手動截圖。
  • 對話框模式 (Chat Dialogues):使用特定語法(如 User:AI:)即可生成類似通訊軟體的對話氣泡,非常適合撰寫「AI 對話錄」或「情境模擬」類型的書籍。

4. 實體書閱讀優化

  • QR Code 自動生成:這是本工具的一大特色。當檢測到連結時,可以選擇自動在旁生成 QR Code。這解決了紙本書讀者無法點擊連結的痛點,拿起手機一掃即可訪問資源。
  • 黑白印刷友善:雖然支援彩色,但預設樣式在黑白印刷下依然保持高對比度與清晰度。

5. 提示與標註 (Callouts)

支援 GitHub 風格的 Alert 語法:

  • > [!TIP]:提示技巧
  • > [!NOTE]:補充筆記
  • > [!WARNING]:警示訊息 這些會被轉換為帶有特定邊框與圖示的 Word 文字方塊,增加版面豐富度。

👥 適用對象

  1. IT 技術書作者:需要貼程式碼、畫架構圖,且最終需交付 Word 稿件給編輯。
  2. 學術論文/報告撰寫者:需要嚴謹的標題層級與圖表管理。
  3. 技術部落客:想將系列文章集結成電子書(PDF/Word)發布。
  4. 教育訓練講師:製作包含大量範例代碼的講義。

🏁 結語

MD2DOC-Evolution 試圖在「Markdown 的高效」與「Word 的普及」之間找到最佳平衡點。它讓你能繼續用最喜歡的方式寫作,同時滿足出版業的標準化需求。