文件

主題、語言與偏好設定

14 款內建主題、可擴展的自訂主題、7 種介面語言，以及一個涵蓋常用開關的應用內偏好設定面板。所有偏好都保存在 config.toml 中。

內建主題

Markion 內建十四款主題，每一款都經過細緻適配：

在偏好設定面板中透過色票選擇主題。（Ctrl+,）。

自訂主題

自訂主題使用 Markion 本機主題目錄中的 .toml 檔。每個檔案需要一個 name, is_dark 標記和一個包含八個顏色鍵的 [colors] 子表：

name = "Midnight"
is_dark = true

[colors]
app_bg      = "#10131a"
panel_bg    = "#171b24"
surface_bg  = "#0f1720"
text        = "#e5edf5"
muted       = "#91a4b7"
border      = "#2b3544"
active_bg   = "#23304a"
active_text = "#9ec5ff"

• 顏色值接受 "#rrggbb" 或不帶 "rrggbb"；省略的顏色會回退到預設調色盤，因此不完整的檔案也能載入。
• 在 config.toml 中設定 theme = "Midnight"（使用主題的 name，而不是檔名）即可啟用自訂主題。
• 首次使用時會在主題目錄安裝 typewriter.toml 示範檔作為起點，其中包含可選的 [fonts] 表（editor、rendered、code），在使用者沒有明確偏好時為原始碼編輯器、正文和程式碼平面提供字型。
• 舊版 .theme 檔會在首次載入時自動遷移：Markion 將其解析一次，在旁邊寫出等價的 .toml，原 .theme 檔保留但此後被忽略。

介面語言

七種介面語言：英語、簡體中文、繁體中文、日語、法語、德語和西班牙語。

偏好設定面板

面板分為一般、外觀、快速鍵、匯出四個標籤頁。外觀集中管理主題、原始碼 / 閱讀 / 程式碼字型、原始碼與閱讀字級，以及段落間距。匯出頁設定預設後端和 PDF / DOCX 選項。

常用設定包括：

• 主題與介面語言
• 在目前標籤頁開啟文件（預設開啟，未儲存的草稿會受到保護）
• 靜默儲存開關與 1–300 秒自動儲存延遲；關閉靜默儲存仍會產生還原快照
• 原始碼 / 閱讀字級 10–32 px，段落間距 0–32 px
• 側邊欄顯示
• 預覽自適應寬度
• 專注模式（淡化目前段落之外的內容）與打字機模式（讓游標所在列垂直置中）
• 程式碼行號
• 同步捲動
• 顯示隱藏檔案
• 標題選單層級（H1–H5 或 H1–H6）
• 依平面的字型（原始碼 / 閱讀 / 程式碼，預設跟隨主題）

偏好設定保存在 config.toml；舊版 preferences.conf 會在首次啟動時自動遷移並保留原檔。

config.toml 常用設定參考

所有設定欄位均可省略。主要預設值和僅能透過檔案設定的選項如下：

theme = "Paper"
language = "en"
focus_mode = false
typewriter_mode = false
code_line_numbers = true
preview_adaptive_width = false
heading_menu_max_level = 5        # 5 或 6
sync_scroll = false
sidebar_visible = true
sidebar_tab = "files"             # "files" 或 "outline"
show_hidden_files = false
open_in_current_tab = true
editor_font_size = 14
rendered_font_size = 14
paragraph_spacing = 12

# 可選的依平面字型；缺省時先跟隨主題，再回退到內建預設
# （原始碼/正文為系統 UI 字型，程式碼為 JetBrains Mono）。
# editor_font_family = "Cascadia Code"
# rendered_font_family = "Georgia"
# code_font_family = "JetBrains Mono"

[auto_save]
enabled = true
silent_save = true
delay_secs = 5

[export]
backend = "builtin"
pdf_engine = "xelatex"

選單動作的快速鍵覆寫保存在 [shortcuts] 表中（動作 id → GPUI 按鍵字串），也可在偏好設定面板中編輯；詳見 鍵盤快速鍵。

資料目錄與日誌

設定、還原檔、主題和按日輪替的診斷日誌均使用適合各平台的 Markion 資料目錄：