Milkdown 兼容 Markdown 和 myMarkdown 这两个插件,但和 Markdown 插件插入公式的语法有区别,理论上 Milkdown 和 myMarkdown 可以做到完全兼容。
简介
下文中的 Milkdown 指的是这个 Markdown 编辑器而非插件,虽然插件同名。实际上插件只是将这个编辑器移植到了 MN 里。
Milkdown 是一款所见即所得的 Markdown 编辑器,让你优雅地编写 Markdown。
Milkdown 同样也是一款插件驱动的 Markdown 编辑器,自定义程度非常高,不管是主题还是各种功能都是通过插件提供。经过专门的优化,现在你可以在 MN 里拥有最完美的 Makrdown 编辑体验。
Milkdown 功能
- 所见即所得:带给你 Typora 的使用体验。
- 快捷键支持
- 斜线指令、选中菜单、顶部工具栏、Block - 可以自由选择是否开启,给你带来 Notion 的使用体验。在不开启时编辑界面完全纯净。
- 公式支持 - 基于 Katex LaTeX 数学公式支持。Katex 渲染速度快,体积小,但 Latex 部分语法不支持。
- 表格支持 - 拥有流畅的 ui 的表格支持。
- 图表支持 - 基于 mermaid 的图表支持。
- 剪贴板 - 支持 markdown 格式的复制粘贴。
- Emoji - 支持 emoji 快捷指令和选择器。
- 粘贴图片 - 支持直接粘贴图片,会自动转为 base64。
- 代码高亮 - 支持黑暗模式。
插件功能
- 兼容 Markdown 和 myMarkdown 这两个插件,但部分语法有区别。比如 Markdown 插件的公式使用的 ```math,但 Milkdown 和 myMarkdown 都是使用的
$$
。理论上来说 Milkdown 和 myMarkdown 可以做到完全兼容。 - 可以自由选择开启斜线指令(Slash,bug 较多不建议开启)、选中菜单(Tooltip)、顶部工具栏(menu)、Block 这四款工具,给你带来 Notion 的使用体验。在不开启时编辑界面可以做到完全纯净。
- 优化卡片上的预览效果,完美贴合卡片大小,不会出现空白。
- 编辑界面可以跟随 MN 的主题,支持黑暗模式。
使用方法
安装插件后,笔记编辑界面右下方的弹出菜单中会增加 Milkdown 选项,点击进入编辑界面。这个插件并不能让卡片原生支持 Markdown。
支持所有 Markdown 语法,包括 GFM 语法,但为了所见即所得,使用上会有一点区别。
-
对于加粗,行内公式这种需要前后闭合的,请不要一开始就输入两边的符号,否则无法识别。最好的方式其实是用快捷键。这点其实和 notion 比较类似,在 milkdown 里其实基本上看不到那些 markdown 的符号,其实习惯里就还好。
-
$$
空格输入块级公式。 -
||
空格创建表格。 -
[ ]
空格创建待办事项,注意两个括号间也要有空格。 -
:
输入表情名。 -
```mermaid
空格输入代码来画流程图。
注意事项
-
对于链接不要直接粘贴,默认会粘贴成 Markdown 格式。可以输入
[文字]()
,光标移过去就可以显示输入框,再粘贴链接。图片也是同理。 -
对于一些有隐藏输入框的,比如公式,链接之类的,最好是使用键盘移动光标进去,如果直接手指点击可能不会显示输入框,尤其是公式在顶部的时候,需要一点技巧。
-
有一定可能在卡片编辑器里会显示不完整,尤其是有公式的时候,主要原因是 MN 没有等待加载完成就停止了加载,这和设备性能也有点关系,后面 MN 会修复。如果特别需要在卡片编辑器中显示完整,比如要在复习模式,就不要在一张卡片中输入太多字。遇到没显示完整的时候,就反复切换一下下一张或者上一张卡片。
讨论
该插件基于 OhMyMN v4 开发,同样可以在 OhMyMN 的 QQ 频道进行交流讨论。频道中有 Milkdown 专属子频道。频道内会发布最新版本,论坛中只会发布签名版本。
下载
milkdown_v1_0_6.mnaddon (4.6 MB)
源码
marginnoteapp/milkdown: Use milkdown as markdown editor of MarginNote (github.com)
更多
快捷键速查表
Mod
在 macOS 系统中指的是Cmd
,在 windows/linux 中指Ctrl
。
必要
Action | Key |
---|---|
复制 | Mod-c |
剪切 | Mod-x |
拷贝 | Mod-v |
换行 | Enter |
退出代码块 | Mod-Enter |
历史
Action | Key |
---|---|
撤销 | Mod-z |
重做 | Mod-Shift-z |
标记
Action | Key |
---|---|
加粗 | Mod-b |
斜体 | Mod-i |
行内代码 | Mod-e |
删除线 | Mod-Alt-x |
段落
Action | Key |
---|---|
常规文本 | Mod-Alt-0 |
H1 | Mod-Alt-1 |
H2 | Mod-Alt-2 |
H3 | Mod-Alt-3 |
H4 | Mod-Alt-4 |
H5 | Mod-Alt-5 |
H6 | Mod-Alt-6 |
代码块 | Mod-Alt-c |
删除换行 | Shift-Enter |
列表
Action | Key |
---|---|
有序列表 | Mod-Alt-7 |
无需列表 | Mod-Alt-8 |
任务列表 | Mod-Alt-9 |
向后缩进 | Mod-] |
向前缩进 | Mod-[ |
表格
Action | Key |
---|---|
下一列 | Mod-] |
前一列 | Mod-[ |
退出表格块并换行 | Mod-Enter |