内置四种主题,主题图库里还有更多。
MarsDawn 内置四种预览主题:黎明、典雅、流行和活泼,各有浅色与深色。从 1.1 版起,你可以在 App 里的主题图库安装更多主题;在访达用“快速查看”预览时,也会用你选的主题。
四种主题
黎明(默认)
典雅
活泼
深色模式
流行主题还没有截图;第四张是深色模式。
- 黎明,默认主题:和这个网站一样的暖色纸感与 Mars Rust 强调色。
- 典雅:比较朴素、像纸质文稿的配色。
- 流行:比较冷调、当代感的配色。
- 活泼:比较明亮、对比度较高的配色。
每种主题都有各自的浅色和深色版本,所以切换 Mac 的外观,连带切换的是主题本身的配色,不只是界面的颜色。
App 里的主题图库
在 MarsDawn 打开“设置 ▸ 外观”,点按“获取更多主题…”。主题图库会在打开时载入清单,只有开着的时候才会连线;没有网络时会显示提示,内置的四种主题照常可用。
- “安装”会把主题加进“浅色主题”和“深色主题”的菜单,以及“显示 ▸ 预览主题”。“移除”会删掉它。
- “检查主题更新”会再向主题图库查一次有没有新版本。
- 可以按用途筛选:审阅代理产出、技术文档、正式输出、笔记分享。
- “举报主题…”会打开一则预先填好的 GitHub issue,或发邮件给我们。
主题图库里有什么
目前有八个主题,都是我们制作并审核的:Dracula、Gruvbox、Nord 和 Solarized 改编自知名配色,并为可读性做了调整;Guide、Ledger、Spec 和 Story 则分别为用户指南、预算表、PRD 和冲刺笔记而做。
经过审核,而且只是数据
每个主题都要经过我们审核、合并,才会出现在主题图库。主题是一个小小的 JSON 文件,只有颜色和几个有范围限制的选项:没有脚本、没有 CSS,也没有作者自带的图像;MarsDawn 安装前会检查每一个值。被举报的主题会在 24 小时内从主题图库下架;如果它有害,下次在已安装的 Mac 上打开主题图库时,也会一并移除,正在使用的话,MarsDawn 会改回黎明。
主题图库只会连到 marsdawn.southern-light.dev/themes/v1/,而且只在你打开它、检查更新或安装主题时才连线。它不会发送账户、标识符、cookie,也不会发送任何文稿内容。
快速查看也用你的主题
在访达选一个 Markdown 文件,按空格键。“快速查看”会用你选的主题显示,已安装的主题也一样,并且跟着 MarsDawn 的外观设置:选“浅色”或“深色”就固定使用,选“系统”则跟着 Mac。
PDF 导出和打印
导出成 PDF 或打印时,页面用的是你为“浅色”选的主题:Mermaid 图表直接画进去,代码块保留语法高亮,分页时也会尽量不让标题和内容分开,或切开表格与图表。免费的 marsdawn 命令行工具使用同一套导出程序,可以用 --theme 指定四种内置主题中的任一种。
页面打印出来之后
大家围着打印出来的页面开会,有人拿笔在页边写字,纸质记录收进档案。
打造自己的主题
在浏览器里打造一个主题:挑选颜色和几个样式选项,实时看效果,再提交成一个 GitHub issue 等待审核。需要 GitHub 账户,但不用安装,也不用 git。提交本身不会发布任何东西;要等我们审核、合并后,才会出现在主题图库。
正在和代理一起工作?让它先做出主题,再在浏览器里调整。
接下来
- 完整的 PDF 导出步骤,从命令行开始:Markdown 转 PDF。
- MarsDawn 现在还做不到的事:这份清单。
- 把导出的 PDF 交给不写 Markdown 的人:分享 PDF。