預覽主題

MarkNode 中的 Markdown 預覽窗格可以套用不同的主題。您可以選擇內建的外觀、讓預覽自動跟隨應用程式主題,或撰寫自己的 CSS,使其符合文件即將發佈的平台風格。

跟隨應用程式主題

預覽預設為 配合應用程式主題:它會使用與您目前應用程式主題搭配的內建樣式,因此從 Paper 切換到 Midnight(或任何其他主題)時,預覽會一併改變配色。除非您想要與應用程式其他部分不同的外觀,否則完全不需要選擇預覽主題。

內建主題

MarkNode 隨附一組內建預覽主題,所有使用者皆可使用。這些主題為唯讀,無法修改,但您隨時可以複製其中一個,作為自訂主題的起點。除了與各應用程式主題搭配的樣式(Paper、Midnight、Sepia、Nord、Solarized Dark、High Contrast)之外,還有針對特定發佈平台與氛圍的外觀,例如:

  • GitHub Light 與 GitHub Dark — 適用於文件的 GitHub 風格呈現
  • Solarized Light 與 Solarized Dark — Solarized 調色盤
  • Serif — 置中的襯線字體欄位,適合長篇文章
  • Compact — 較緊湊的版面,適合資訊密集的參考資料
  • Academic、Newsprint、Dracula 等更多主題

內建主題的基本背景、文字、連結與邊框顏色皆取自您目前使用的應用程式主題,因此無論淺色或深色模式都能呈現良好效果,不需重新選擇。(另外還有一個內部的 Default 樣式,作為 配合應用程式主題 的基礎;您在選單中選擇的是 配合應用程式主題,而不是直接選擇 Default。)

若要切換主題,請按一下預覽窗格標題列中的 預覽樣式 按鈕,或在預覽中任意位置按右鍵並使用樣式清單。選擇 配合應用程式主題 即可重新跟隨應用程式主題,或選擇任一特定樣式將其固定。變更會立即套用到所有預覽畫面——包括編輯器旁的停駐預覽,以及您已取消停駐的任何預覽視窗——並會在各工作階段之間保留。

擴充功能提供的樣式會列在 來自 加上該擴充功能名稱之下——請參閱擴充功能範本與樣式。

建立自訂主題

在預覽樣式選單中,選擇 以此建立新樣式…,即可根據目前使用中的主題建立自訂主題:

  1. 輸入新主題的名稱。名稱不可與內建主題名稱相同。
  2. CSS 編輯器會開啟並預先填入來源 CSS——依您的喜好進行編輯。

在您輸入的同時,預覽會即時重新呈現。CSS 在儲存前只會保留在記憶體中,因此您可以放心嘗試;如果改變主意,關閉編輯器即可捨棄編輯內容。

若要編輯您已建立的自訂主題,請選取該主題,然後從同一個選單中選擇 編輯目前樣式…。

儲存與分享

儲存自訂主題時,它會存放在您的全域主題庫中,因此在這台電腦上的所有專案都能使用。您也可以勾選 在目前專案中儲存副本,將主題寫入專案,讓主題隨專案一起移動。如果您將專案提交到 Git,每位複製該儲存庫的協作者都會看到相同的預覽。

當您開啟的專案包含您尚未擁有的自訂預覽主題時,該主題會在專案開啟期間出現在您的樣式清單中。

自訂 CSS 可設定的樣式

自訂 CSS 的作用範圍僅限於預覽容器(.markdown-preview),因此不會影響編輯器、側邊欄或 MarkNode 的其他任何部分。您可以設定:

  • 內文字型與大小
  • 標題、清單、引用區塊與表格
  • 程式碼區塊、行內程式碼與語法醒目提示顏色
  • 間距、內距與內容的最大寬度

如果您希望自訂主題像內建主題一樣自動適應淺色與深色模式,請從複製內建主題開始——您的副本會繼承該主題感知的基礎樣式,您可以再從那裡調整。

由於 CSS 只能調整視覺呈現,無法變更底層的 HTML,因此無法進行大幅度的 DOM 結構調整。

刪除自訂主題

選取自訂主題,然後使用樣式選單中的刪除動作。系統會先顯示確認訊息。如果您刪除的是目前使用中的主題,MarkNode 會改回預設的內建主題。內建主題沒有刪除動作,無法移除。