预览主题

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 的任何其他部分。您可以设置:

  • 正文字体和字号
  • 标题、列表、引用块和表格
  • 代码块、行内代码和语法高亮颜色
  • 间距、内边距和内容的最大宽度

如果您希望自定义主题像内置主题一样自动适配浅色和深色模式,请从复制一个内置主题开始。您的副本会继承该主题的自适应基础样式,您可以在此基础上进行调整。

无法对 DOM 进行大幅重构,因为 CSS 只能调整视觉呈现,而不能改变底层 HTML。

删除自定义主题

选中一个自定义主题,然后使用样式菜单中的删除操作。系统会先显示确认提示。如果删除的是当前使用的主题,MarkNode 会回退到默认的内置主题。内置主题没有删除操作,无法移除。