要在 Google 協作平台中同時達成 Markdown 撰寫與 LaTeX 公式渲染,最專業且高效的方案是將 Marked.js (處理 Markdown) 與 MathJax (處理 LaTeX) 整合在同一個「內嵌程式碼」方塊中。
這對於整理電機工程教材(如馬達控制理論或 AI 演算法)非常方便,因為你可以直接用純文字撰寫複雜的內容。
整合實作方案:全功能內嵌腳本
請按照以下步驟操作:
在 Google 協作平台選擇 「插入」 > 「內嵌」 > 「內嵌程式碼」。
貼入以下整合好的程式碼:
使用要點說明
編輯方式: 你只需要修改 const rawContent = \ ... `;` 這一區塊內的文字即可。它支援完整的 Markdown 語法(標題、清單、粗體、程式碼區塊)。
LaTeX 語法:
行內公式: 使用單個金錢符號 $ ... $。
獨立區塊公式: 使用兩個金錢符號 $$...$$。
樣式自訂: 我在 <style> 區塊中加入了一些基本的 CSS,您可以根據系所網頁的視覺風格(如龍華科大的代表色)自行調整 h1 的顏色或字體。
為什麼選擇這個方法?
高維護性: 所有的內容都存在同一個程式碼塊中,不需要分開管理圖片或多個文字框。
專業呈現: 對於電機工程的複雜公式(如矩陣運算或積分),MathJax 的渲染效果遠優於直接貼圖。
適合 RAG 教材: 如果您之後想將這些網頁內容作為 RAG 系統的語料,這種結構化的純文字內容也更容易被 AI 處理。
您是否需要將這套樣式應用在特定的課程單元(例如數位邏輯實習或無人機巡檢技術)中?
這是因為 MathJax v3 在預設情況下,關閉了單個金錢符號 $ 的行內公式識別。這是官方為了防止內文出現貨幣符號(例如 $100 USD)時發生誤判的保護機制。
要成功讓 $V$、$I$、$R$ 順利解讀,我們必須在載入 MathJax 腳本之前,明確加上配置宣告。
請用以下修正後的完整程式碼替換原有的內嵌內容:
方法 A:使用 <textarea> 儲存內容(最推薦,免去反斜線地獄)
利用 HTML 的 <textarea> 標籤來存放教材內容,它可以百分之百保留最原始的文字與單反斜線(\),你之後從其他地方複製 LaTeX 公式過來時,完全不用做任何修改。
請用以下程式碼替換 Google 協作平台中的內嵌程式碼: