Joplin 主题美化与自定义

一、内置主题与深色模式

1. 打开「设置 → 外观」。
2. 在「主题」中选择 浅色、深色 或 跟随系统（推荐，夜间自动变深色）。
3. 「编辑器主题」决定 Markdown 编辑器的配色，同样支持浅色 / 深色 / 跟随系统。

深色模式对夜间写作非常友好，也可以减少 OLED 屏幕的功耗；「跟随系统」能自动适配操作系统主题。

二、调整界面外观

• 字体：在「设置 → 外观」中可分别设置界面字体、编辑器字体与等宽字体，并调整字号。
• 笔记列表密度：可选紧凑或宽松布局；侧栏宽度可直接拖动调整。

字体选择上，中文用户建议使用「思源黑体」或「微软雅黑」，代码字体可以使用 Fira Code 或 JetBrains Mono。

三、导入社区主题

1. 在「设置 → 外观 → 显示高级设置」中找到 自定义样式 CSS（Custom stylesheet），把主题 CSS 全文粘贴进去并保存。
2. 或把 CSS 保存为 userchrome.css 放到 Joplin 配置目录（帮助 → 打开配置目录），重启生效。

四、手写自定义 CSS

Joplin 的自定义样式分两层：userchrome.css 控制应用界面（侧栏、按钮、面板），userstyle.css 控制笔记正文的 Markdown 渲染效果。修改后重启 Joplin 即可生效，CSS 改动不会改变笔记中的 Markdown 原文。社区主题可以在官方论坛与 GitHub 搜索，导入前先备份原有 CSS；官方插件库中也有主题插件可以一键安装。更多示例可以参考 GitHub 仓库 的讨论区。主题只是视觉外壳，不影响笔记数据；换主题前建议先导出 JEX 备份。

五、常见问题

主题会随笔记一起同步到其他设备吗？

不会。主题与界面设置属于本地配置，不参与笔记同步；同一账号在不同设备上可以各自使用不同主题。

如何恢复默认主题？

在「设置 → 外观」把主题改回浅色或深色，并清空「自定义样式 CSS」文本框、删除 userchrome.css / userstyle.css 文件即可。

自定义 CSS 的生效范围以官方说明为准，官方文档中也有插件与主题章节，见 插件与主题文档；社区主题通常会在介绍页写明适用版本，安装前可以留意一下。如果你对 CSS 不熟悉，先用内置深色模式就足够舒适，不必急于折腾主题。更换主题前先截图保存当前界面，方便之后对比效果。CSS 中涉及字体族时建议同时指定回退字体，避免中文显示异常。