忍不了了，做了个插件让 OneNote 支持 Markdown

[ccyixia]

1 年多前，由于工作原因，主力开发机换成了 Windows ，还入了 Office 365 全家桶。于是在时隔多年后，再次用起了 OneNote 。不得不说，都快 2022 年了，OneNote 的码字体验还停留在十多年前，一堆大大小小的遗留问题。但我实在懒得折腾什么 Notion Obsidian （没有复杂的知识管理需求），只想找个本地 /靠谱 /大厂出品 /开箱即用的笔记软件，简单记录下工作相关内容。 毕竟人一旦习惯了 Markdown 的符号 # 和 -，就真的回不去了。于是研究了下 OneNote 的 api ，决定自己动手，丰衣足食。

废话不多说，直接上动图。

简单来说，实现了基于行的实时渲染，每次按回车时自动渲染当前行。当然，这个实时 跟新世代编辑器字符级别的没法比，但已经足够好用了。

不仅如此，终于在 OneNote 上实现了可用级别的代码高亮，输入```创建代码块后，每敲一行自动着色。（之前要在 OneNote 里插入代码简直反人类，心疼自己）

以及 LaTex 转换到 OneNote 原生的数学公式（不是图片）。

除此之外，还支持TOC / todo / 水平线 / 脚注 等常见的语法，直接拿已有的 Markdown 内容粘贴到 OneNote 中， 然后按 F5 渲染，大概率是可以完美还原的（强行自信。。不过毕竟是 beta 版本，出现意外欢迎反馈）。

你可能会问：这种转换是单向的吗？我如果有一天想导出 Markdown 纯文本怎么办？在我看来，原始 Markdown 丢失是绝对不能接受的，所以我花了很大力气来解决这个问题：笔记中每个段落的 Markdown 原文都以某种格式隐藏存储在自身之中，可以随时读取，不依赖外部文件，任意编辑也不会破坏。而且这种格式是公开透明的，只需要用 OneNote api 拿到 XML 格式的笔记内容，所有秘密一览无余。

更重要的是，渲染后的内容可以原地随意增删修改，不必再重新切换回 Markdown 形态编辑；而且在导出 Markdown 时，内容也会相应更新——是的，实现了双向更新。当然，如果由于某些原因，你想切换回 Markdown 形态编辑，也是支持的。按 ctrl + , ，即可在编辑和预览之间切换。

说完实时渲染和双向更新，接下来夸一下 OneNote 。。其实 OneNote 编辑器在刚推出的时候还是很超前的，有了现在流行的 block level 编辑器的雏形。无论是列表、段落、表格，书写和调整起来都非常得心应手。（可惜之后多年编辑器层面都没什么大的更新，逐渐有点落伍了。不过微软家产品向后兼容都做的非常好，所以估计只能保守，不敢太激进。这里顺便提一下某老牌笔记软件，每一次大更新确实有新的东西，但后果就是会有不少用户抱怨之前的笔记格式乱了。微软的产品是绝对不会出现这种情况的）说回正题。。也多亏了这些设计，结合 Markdown 之后居然毫不违和，整体体验下来有点现代编辑器的味道了。个中玄妙，就待各位亲自上手把玩了。

One more little thing ，被吐槽无数的英文自动变成 Calibri 字体的问题好像也因为这种二次渲染模式的引入无意中解决了。。

最后，隆重介绍下，插件的名字：OneMark （毫无创意但也顺理成章），官网： https://onemark.neuxlab.cn 欢迎大家试用反馈。

ps: 只支持 OneNote Windows 桌面版，不支持 UWP 版本。

@安装后没有反应的小伙伴们：请再次访问网站，试试下载64位版本。。正确安装后看到 OneNote 里多了个 tab，不需要任何额外多余的设置。

如果64位的也不行，请加微信群沟通吧。

（欢迎大家加群，不过有一点要小声说明下：这几年卑躬屈膝做乙方，让我患上了严重的即时通讯恐惧症，特别怕消息提示音和电话。。所以，我本人在群里可能不会特别活跃，回复不一定及时，但每天还是会定时看的。

上面的群满了无法扫码加入，又建了一个：

🎉 OneMark 在 producthunt 发布啦！麻烦大家帮忙投票转发，跪谢！ https://www.producthunt.com/posts/onemark

[Birdy0017]

@ccyixia uwp 是实时同步的，2016 版是老长一段时间同步的。不过有个一键同步的快捷键，可以设置个程序，检测是否在 OneNote2016 聚焦，如果聚焦就一直按同步。

[Birdy0017]

强强强强！

[zoumouse]

牛逼！

[qrqhuang]

泪目了， 这是什么样的神仙楼主呀

[88268459]

厉害了，我只能支持一下

[Funnyang]

忍不了了好多年了，奈何没能力。要是可以支持 mac 就好了，现在的笔记软件层出不穷，但是我还是觉得 OneNote 最好用，但是奈何很多笔记都涉及代码，排版实在是太难了，所以 OneNote 总是只能放在一旁怀念。。

[noinil]

看起来非常厉害👍 可惜我对微软产品没有什么好感

[ccyixia]

@Funnyang mac 确实比较难搞，后面看有没有其他办法解决。

[hwdef]

安装的时候如果选择 只为本用户安装，可以不申请 uac 吗

[ccyixia]

@hwdef office 插件需要注册 COM 组件，必须要往注册表里写东西，所以才会要求提权吧。说实话安装程序用的是微软提供的现成的，我都没怎么改。

[sfqtsh]

@ccyixia #210 我没记错默认是写到 HKLM ，但可以改成写到 HKCU 的

[cccer]

如果能快捷键将全文转换回 MD 就方便的，再配合 F5 快捷键，两种格式快速转换编辑。

[ccyixia]

@cccer 来回全文渲染如果内容很多可能会卡顿，所以还是单行 ctrl+, 更快捷些。实际使用来说，不太需要全文转换为 md 再编辑，局部编辑足够了。（当然如果有是最好的，但还是卡顿的问题）

[Jakarta]

很强大，OneNote 上终于能支持 markdown 了。
不过貌似右键菜单会非常卡。

[ccyixia]

@Jakarta 应该对右键菜单没什么影响才对。如果你确认很卡的话，可以在 onenote 里先不加载 OneMark 试试。

[zliea]

膜拜大佬

[Jakarta]

@ccyixia 不加载也卡，那很可能是我自己的 OneNote 的原因。

[appmews]

不是吧不是吧，你们不知道有 gem 珍这个外挂插件吗？
效果如下图，
<img src="https://cdn.jsdelivr.net/gh/abcmiao/img@main/pic/202112211841316.png"/>

顺带给大家解决下 onemark 不显示的问题
需要进入设置：
点文件，选项，加载项--点击 neux.onemark,最下 COM 加在项后的转到点一下，勾选上 neux.onemark ，保存，退出，再打开

[jijiang]

未加载, 加载时出现运行错误
版本 2111 Build 16.0.14701.20254) 64 位
重装了几次还是不行
是还不支持这个版本吗?

[ccyixia]

@jijiang 先卸载 onemark ，控制面板里找到 office ，右键修复，再重装试一下。还不行就重启电脑试试。

[Foryou920]

卧槽，太牛逼了大佬

[Echoldman]

这个真棒，虽然我不用 OneNote ，但是必须赞一下！

[lhgtop]

我分享一下插件的安装心得;

1. 如果 onenote 是 64 位就安装 64 位. 32 位安装 32 位的. 具体可以打开 onenote 查看

2. 如果安装后没有看到多出来的菜单标签, 说明安装后没有加载. 可以在选项 com 加载项里, 看一下, 如果有, 但是没有启用, 就勾选启用.

3. 如果勾选启用失败, 就用 everyone 模式再安装一遍. 这个写入的注册表项目不一样. 建议都用 everyone 安装.

[ccyixia]

@lhgtop 感谢提供信息，everyone 这个没人提起过，我试验一下。

[yyyyyyyhb]

太牛了！希望后续可以加入自定义字体

[itemqq]

卡巴斯基有报🐎诶


[ccyixia]

@itemqq 误报，放心食用。

[OneNoter]

@ccyixia 感谢提供这么好的插件。这里提几个功能建议：
1 ．建议把 markdown 的各级标题与 OneNote 默认的标题样式对应起来。
就是说，如果我用#定义了一个一级标题，它的段落样式也对应设置为 OneNote 默认的一级标题。因为这样对应后，才方便使用其他插件宏自动生成目录。

2 ．建议把默认正文字体调成 12 或 14 号。
目前默认的正文字体是 11 号，感觉字有点小。建议增大到 12 或 14 号。方便阅读。
或者也可以把默认正文字体大小与 OneNote 设置里面的默认字体大小对应起来。

3 ．能不能增加功能，可以锚定 PDF 做链接笔记？
就象 OneNote 默认链接 word 文档的链接笔记那样。在阅读 PDF 的时候，同时打开 OneNote ，在输入或截图 PDF 的时候自动生成链接笔记。PDF 阅读器，可以用这个 www.sumatrapdfreader.org/ 。

再次感谢。

[xiaozhubin]

已安装，我就是来围观一下大神

[itemqq]

@ccyixia 并无恶意揣测 hhh ，但是有些人会往 OneNote 里存储一些隐私数据，可能对这个比较敏感，大佬是否考虑开源，或者注册工作室运营一下？个人是愿意为此付费的。

[neilyoone]

Mac 版 在线等~

[moonlune]

不错！ OneNote365 测试完毕，很不错，非常感谢！

[chillcirno]

有个问题, 标题中插入``代码块的话, 代码块的字偏小.
还有群二维码能更新一下吗, 方便尝鲜! 谢谢大佬!

[ccyixia]

@OneNoter

1. 这个可以改进，不过 markdown 里有[toc]可以自动生成目录，应该不需要其他插件再去做这件事了吧？除非是多页的目录。

2. 样式后面会开放配置和修改。

3. 链接 pdf 暂时超出了功能范围，我会考虑下技术方案，但是优先级不高。不过我试过，链接 word/ppt 之后也是可以使用 markdown 语法的。

[ccyixia]

@chillcirno 感谢反馈，确实存在这个问题，后面会修复的。群二维码已更新。

[ccyixia]

@OneNoter 我搜了下，另一个 OneNote 插件 Gem 有这样的功能。你有了解过吗？是否能满足你的需求？

[OneNoter]

@ccyixia 谢谢答复。
1 ．我对 markdown 不熟悉，才开始用。没想到还有[toc]这样好用的东西。但目前的功能有点不足，如果页码内容较多，想要在段落后面增加返回目录的链接，可不可以增加这个？
如果能够把 markdown 的目录层级和默认的目录层级对应，通用性会更高一些。

2 ．是否可以增加对中文符号的支持。比如在输入 [toc] 的时候，自动更正为[toc]。在行首输入》的时候，自动替换为>作为注释内容。

3 ．链接 PDF 确实超出了功能范围，这不是看你开发了这么好用的 markdown 支持，不免想要更多。markdown+PDF 链接文件支持，相信能满足大部分人的需要了。我发的那个开源 PDF 阅读器，它的配置文件中有 PDF 文件的保存位置、页码等数据。我才在记录 OneNote 笔记的时候可以同时读取整个内容，保存在该端记录里面，并自动创建链接，是不是就可以实现链接到指定页码的功能？---不需要链接到指定段落那么精确。这样的话，就和目前保存了 markdown 源码的做法类似了。开发起来会不会相对容易实现一点？
当然，我不懂编程，仅是个人猜测。
www.sumatrapdfreader.org/

[OneNoter]

@ccyixia OneNote Gem 有个链接 PDF 的功能。我曾试图联系作者购买。但作者定价较高，要 150 元，而且只能 1 台台式机+1 个笔记本。我家里和办公室两台台式机，两台笔记本，这样使用的话，需要购买 2 份。感觉价格贵了。如果 Markdown 插件能够实现类似功能，并适当放宽使用台数的限制，在 50 元左右的价格，我认为是可以接收的。
适当的付费使用，我认为对用户和开发者都是有益的。

[hanheihei]

好用，超级棒！！！安装也方便，一直下一步就可。

[Scorp]

甚至似乎顺带解决了 onenote 万年的中英文字体问题

[ccyixia]

@Scorp 哈哈 是的 （其实上面介绍里提到了，但好像注意到的人不多

[OneNoter]

@ccyixia 祝元旦快乐！作者君，期待你继续更新啊。

这些年，有多少灵感从你脑中闪现又被遗忘？
有多少洞见停留在思考但又没有付诸行动？
有多少知识要点沉没在信息的海洋，再也没有被记起？
——2022 年，你需要 [OneNote] 。

[ianzhuo]

真的是太完美的一个插件了，真心希望可以自定义字体

[SpecterShell]

更新界面的 OneMark 全部打成 OnMark 了。

另外可以试试用 WiX Toolset 制作 msi 安装包。

[vopsoft]

office 2016 -64 自带的 onenote 加载失败

没有可用的兼客性信息

[ccyixia]

@vopsoft 可以根据帮助文档排查下问题，或者使用 tray 模式。

[ccyixia]

@SpecterShell 感谢反馈，确实存在 typo 。

[OneNoter]

使用环境：Windows11 64 位，Office 365 64 位。均更新至最新版。
安装完成时提示错误，有 2 个对话框。
1.无法关闭 Microsoft Word ，因为有一个对话框处于打开状态。请单击“确定”切换到 Word ，然后关闭对话框。
实际并没有打开其他 word 窗口。

2.Word 无法打开现有文件，提示路径为用户文件夹的 normal.dotm 。
看起来是一个模板文档。

虽然有这两个错误提示，但还是能正常工作。

另外，提供建议，
1.能不能设置默认的页面背景色和字体颜色，这样好达到最好的界面效果。
可以预设两种，一种日间阅读的，一种暗黑模式下来的。
我个人比较喜欢 Logseq 的蓝底白字样式，你看能不能参考一下？

2.目前的注释框和横线的长度是固定的。能不能改成匹配当前容器的宽度呢？当容器宽度改变是，自动修改表格和横线的长度。

[OneNoter]

再补充一点：
目前的刷新快捷键 F5 ，与 OneMore 插件的默认快捷键冲突了，能不能调整呢？

[getrix]

能支持亮色主题的代码样式吗

[HFX3389]

楼主，我想提个建议：

插件默认的 11 号字体太小了...我用 Onenote 都是用 16 号部分都用到 18 号的字体大小的...这个 11 号着实有点小

[ccyixia]

@HFX3389 明白，下个大版本会开放样式编辑的。其实 OneNote 可以按住 ctrl+滚轮放大页面，你可以暂时试一下。

[OneNoter]

@ccyixia 老大，下个版本能不能加入设置默认页面背景颜色、字体颜色的自定义功能？或者单纯增加一个功能可以一键把页面背景颜色、字体颜色设置为设置好的颜色值。我喜欢蓝底白字，就像 logseq 那样的界面，感觉比较美观啊。谢谢。

[hrtdream]

@ccyixia microsoft 365 版 onenote ，只有第一次输入标题时，字体为黑色，当再次输入标题时，字体颜色会发生改变，会变为黑色，淡色 50%。

[sunyang]

刚刚更新了读取字体模式，但是在我的 onenote 2021 LTSC 上好像不起作用。

[sunyang]

新建的笔记一直默认设置成微软雅黑。

[TPOB]

我也尝试了一下新版，更新提示说解决了字体问题，但我这也还是默认设置成微软雅黑

[sunyang]

更新了 0.1.3.1 版本这个问题依然存在。
1 ，选项设置中调整的字体无用，新建笔记本会默认为微软雅黑 14 号字体
2 ，开始标签卡字体设置栏被锁死无法调整全局字体。
3 ，选中段落调整字体选项可以使用，这个调整完以后开始标签卡中字体设置就可以使用了。但是渲染后的字体依然为微软雅黑。

[ccyixia]

@sunyang
@TPOB
确实存在这个问题，是打包的时候有个组件没有更新成功，会尽快重新发布的。如果后续遇到问题，建议给官网留的邮箱发邮件，这样会更即时些，v 站不是每天都看。:)

[ccyixia]

@hrtdream 这个问题 0.1.3.1 已经解决了

[sunyang]

@ccyixia 本来有发邮件的想法，但是后来看到你说有即时通讯恐惧症，想了想还是发在帖子里，你想看的时候再看吧。

[huntley]

更新了插件，系统更新到了 win11 build 22000.527 之后，开始用不了了，无法把 markdown 渲染出来，一点转换就卡死。

[huntley]

OneMarkSetupX64.0_1_3_1

Microsoft® OneNote® 适用于 Microsoft 365MSO (版本 2201 Build 16.0.14827.20186) 64 位

版本 Windows 11 专业版
版本 21H2
操作系统版本 22000.527

[wubei7231]

@OneNoter onenote 自身在视图里有这个功能。

[Qotal]

@huntley 实时模式下有问题吗

[ccyixia]

@huntley 是否是安装在虚拟机里呢？你是用的 f5 渲染还是实时模式？

[huntley]

不是安装在虚拟机的，f5 渲染和实时模式都不行。

[huntley]

@ccyixia 不是安装在虚拟机的，f5 渲染和实时模式都不行。

[ccyixia]

@huntley 邮件联系我一下 onemarkdown#gmail

[huntley]

@ccyixia 已经把 gif 发您 gmail 了

[sunyang]

@ccyixia 字体的 bug 大概什么时候修复啊？

[sunyang]

最新版解决了字体问题，但是插入一堆图片的时候，渲染会卡死。 @ccyixia

[ccyixia]

@sunyang 怎么插入的，录屏看一下。

[sunyang]

@ccyixia 是我电脑的问题，重启后问题已经消失。

[SpecterShell]

软件的版本号和安装程序写入注册表的版本号不统一

[yesfirst]

哇，太感谢老哥这个东西了。 就是群二维码过期了，还能分享下新的二维码进去吗？

[ccyixia]

@yesfirst https://neux-static.oss-cn-hangzhou.aliyuncs.com/onemark_group.jpg?OSSAccessKeyId=LTAIpDfaYELt3XkY&Expires=1651001048&Signature=NnLAcp9XtbIh0s7wNxYi94tEP4Q%3D

[ccyixia]

@SpecterShell 是有这个小问题 不过影响不大

[kp31]

老哥，一个小问题，代码块如何还原，按了 ctrl+，似乎只能把里面的内容变回去，但代码块并没有变回```js 这种初始文本

[qW7bo2FbzbC0]

等一个 mac 版本

[ccyixia]

群二维码更新 https://cdn.neuxlab.cn/onemark_group.jpg

[qfush1]

群二维码能更新一下吗, 方便尝鲜! 谢谢大佬!

[ccyixia]

@qfush1 更新了 https://cdn.neuxlab.cn/onemark_group.jpg

[py2ex]

不支持 UWP 版本 可惜

[ccyixia]

@py2ex 微软马上要干掉 uwp 版本，和桌面版合并了，所以早晚都能用上:)

[patrickwangqy]

群链接有吗？

[acrisliu]

装完被公司当成恶意软件发邮件到大老板那里去了😂

[patrickwangqy]

@ccyixia 请问能更新下加群二维码吗

[ccyixia]

@patrickwangqy 更新了 https://cdn.neuxlab.cn/onemark_group.jpg

[gpseaver]

@ccyixia 老哥，onemark 提示过期了，从官网 neuxlab.cn 下载最新版还是一样的提示。

[ccyixia]

@gpseaver 刚更新了 重新下载 0.1.6.7 试一下

[gpseaver]

@ccyixia 已更新！可以用了，感谢！

[AmaQuinton]


[AmaQuinton]

导入 typora 创建的 md 文件报错了, 楼主帮忙看下

[wren]

楼主，0.1.6.7 的下个大版本都有什么重大更新呢？看到预告有点期待

[freakolive]

Mac 端留下了羡慕的泪水…

[wlee]

能不能建个 OneMark 反馈的 QQ 群？微信太不友好了

[fengxiaoxiaoYSH]

大佬，问个问题，在 F5 全文渲染之后，如何做到取消全局渲染，恢复 markdown 格式？

[sssq]

好巧不巧，同求 q 群以及同问怎么全局恢复源码

[ccyixia]

@fengxiaoxiaoYSH @sssq 如果是撤销刚才的 F5 渲染，可以按 ctrl+z 。没有全文恢复为 markdown 格式的功能，可以按 F8 导出 markdown ，文本会自动复制到剪切板上。