文档

主题、语言与偏好设置

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 数据目录：