VNote：一个更懂程序员和 Markdown 的笔记

[tamlok]

我使用 Markdown 来记录笔记大概有四五年了，尝试了很多不同的笔记软件和编辑器，包括为知笔记、有道云笔记、MarkdownPad、初次惊艳的 Typora、StackEdit 和作业部落等。最后觉得这些笔记和编辑器并不能满足自己的需求。个人认为，Markdown 需要预览是对 Markdown 的一个最大误解。于是，我自己基于 Qt 搞了一个笔记软件—— VNote。

VNote 的特性包括：

• 使用 语法高亮 而不是实时预览来提供舒适的编辑体验；
• 编辑时 实时原地预览图片链接；
• 编辑时，代码块支持语法高亮；
• 支持 Mermaid 流程图，MathJax 数学公式；
• 支持 Vim 模式；
• 支持 HiDpi ；
• 支持大纲显示；
• 支持自定义编辑与阅读 CSS 样式；

以下是 VNote 编辑时的一个界面：

目前 VNote 处于 1.6 版本，正在活跃开发中，欢迎大家尝试反馈！

下面附上一些之前写的关于 VNote 设计理念和特性的文章：

• Github 项目
• VNote: 一个舒适的 Markdown 笔记软件
• 靡不有初，鲜克有终——写在 VNote 半周岁
• 一踩一个准之 Markdown

谢谢！

上面这张图片为了演示语法高亮特性的，所以把几乎所有Markdown元素都放在一起，显得有点凌乱；而且这个图片是之前一个版本的截图，非本地图片还不能实时预览。

下面附上一张最新版我自己的笔记截图。感谢大家提的意见！行高问题的确是一个要注意的问题。另外，还有其他一些特性希望大家能去看看项目主页的介绍或者文章里面的介绍，或者就有那么一两个特性把您打动了呢？转角也能遇到爱，是吧？ :) 再次感谢大家！！！

上图中把我们程序员里面非常方便的highlight trailing spaces特性拿过来了，因为Markdown里面往往是空两个换行实现强制换行。

一个操作录屏：

附上微信公众号 VNote笔记，后面用于推送使用技巧和更新。还在观望的V友可以考虑关注一个，地铁上无聊的时候看看～～

项目网站： VNote

支持丰富的导出选项（比如多合一PDF）以及强大的全文搜索啦！

[lifeintools]

点赞~

[SuperMild]

看起来很不错！

[GlobalNPC]

Qt 啊，好厉害

[tamlok]

@infun 哪里，我就只会这个了～～以前学 C++的时候，Web 开发还没有现在这么流行

[tamlok]

@SuperMild 谢谢！后面还会根据自己的使用不断完善。最近觉得 UML 对看代码挺有帮助的，所以打算支持 UML ～～

[Krime]

看起来有点乱，建议调整一下边距和行间距，效果应该会好很多

[tamlok]

@Krime 谢谢反馈！这个只是演示文档，将尽可能多的 Markdown 元素放在一起。而且这个是比较早的版本，目前版本的话那两个图片链接下面应该预览有图片的。后面我试着改一下边距。谢谢！

[kohnv]

和 emacs 里的 org mode 挺像的

[learnshare]

行高需要大一些，字都挤到一起了

[tamlok]

@learnshare 好的！谢谢反馈！这是 QTextEdit 默认的设置，一直没改动，后面我改善一下。

[lonenol]

我觉得 markdown 编辑工具最重要的就是对表格支持的友好一点,最好达到 org-mode 那种程度.其它的功能用哪个都没啥区别,搞的再牛逼也比 vim sublime 之类的强不了多少

[tamlok]

@lonenol 原地预览图片还是比 Vim 强很多的～后面 VNote 会针对表格进行优化，目前还没有做到这一步。计划是：图片、公式都是原地预览，表格是实时维护行高之类的，使用纯文本|之类的达到一个类似于 Excel 编辑的体验。org-mode 我没有体验过，我是 Vim 党，哈～ VNote 的想法也是从 Vim 来的。我之前使用 Vim 来编写 MD 笔记两三个月，觉得加上 conceal 特性效果很不错，可惜就是图片显示不了，所以按照这个想法，摒弃实时预览，实现了一个 VNote。谢谢！

[qiqico]

> “使用 语法高亮 而不是实时预览来提供舒适的编辑体验；”

为啥给程序员看代码而不是排版优雅好看的预览，就是更懂程序员？没感觉这种体验会更好啊，乱乱的

[skadi]

mark

[tamlok]

@qiqico 因为从我个人角度来看，使用 Markdown 主要是它简单的标记。预览只是用于阅读，并不是用来编辑的。目前大多数编辑器都提供实时预览，编辑的时候左看右看的，而且还把整个屏幕都占了。Typora 的想法非常惊艳，但是在使用一段时间后，我发现它把我输入的每一个字符都格式化，我能控制的就很少了；而且掺和的越多，兼容性和 Bug 就越多。

这里说“更懂程序员”，是从另一个角度来看的：Vim，分割窗口，掌控，编辑时代码高亮等等。（不过也可能是我以偏概全了，以为 VNote 更懂我这个程序员，就更懂所有的程序员 :( ）。另外，VNote 下一个版本还会支持 PlantUML。

这个图片显得有点乱是因为为了展示语法高亮，把所有元素都放在一起了；而且还有前面不少大大提到的行高问题，后面我会注意这一点！谢谢反馈！:)

[Kilerd]

挺好的，就是看起来很乱。


所以我还是选择 typora

[tamlok]

@Kilerd 更新了一张截图，乱是因为把所有元素都放在一起演示了。Typora 也非常好，代表不同的方案吧。一个极端是直接纯文本那样编辑，一个方案是提供实时预览，一个方案是 VNote 这种，另一个极端是 Typora 那样直接类似于富文本编辑。其实我觉得 Typora 就是一个快捷键的 Word。:)

[freestyleyooo]

看起来好乱啊，没印象笔记好看

[mokeyjay]

看起来不错，赞一个

[tamlok]

@freestyleyooo Markdown 是标记语言，编辑的时候和富文本没法比，阅读的时候则是有过之而无不及。当然不敢和印象笔记比颜值了啦！ :) 但私以为，还是比有道云笔记好看那么一点点～哈哈！谢谢！

[bequt]

很不错我产品，谢谢

[Lispre]

我点击退出之后， 总是报告意外退出

[Garantion]

很好的产品，用了一小会儿，说一点我自己的想法
优点：
- 流畅，界面简洁
- Vim 模式很给力
- 笔记本结构设计很好

发现一些地方可以改进：
- 新建笔记本的时候我试了很多种方式都不能在默认路径之外新建
- 好像没有实时预览功能
- 删除笔记本的时候，我没勾选保留本地内容，直接无响应退出

毕竟是开源的，很不容易，加油！

[tamlok]

@Lispre 请问是什么系统呢？可以的话，麻烦在 Github 或者 QQ 群或者邮件里面说一下详细的情况，可以改进，谢谢！

[Lilykissme]

马克一下，体验一下再谈。

[tamlok]

@Garantion 哎呀，不能在默认路径之外新建那个是个 Bug，刚添加进去的。删除笔记本这个，我这边倒不会无响应退出，不知道您是什么平台呢？ VNote 不提供一边编辑一边实时预览的功能，只区分编辑和阅读模式。谢谢反馈！

[Garantion]

@tamlok #26 是 Windows 7 64 位，可能是偶然现象。
其实不提供实时预览也行，毕竟写多了基本都能脑补出来渲染后的样子 233

[zuolan]

让我想起了 Qownnotes （大概）这个日更狂魔，真正的最强大 Markdown 笔记工具，但是功能那么复杂，实在玩不过来。。。。

[tamlok]

@zuolan 顿悟了以后，现在通过实时预览来编辑 Markdown 的编辑器我基本都不看了～哈哈。VNote 没有待办事项，很简单的。

[tamlok]

@Garantion 刚 Fix 了不能添加其他位置的笔记本的 Bug。VNote 是希望通过语法高亮以及预览图片等方法来尽量降低 MD 的编辑与阅读的割裂感。谢谢！

[babytomas]

支持，我在 deepin 看到你来着 ...

[tamlok]

@babytomas 谢谢～等后面 deepin 应用商店收录了欢迎尝试哈～

[wzw]

@tamlok win 的用户还是最多的吧，一开始先把 win 的做好呀。

[tamlok]

@wzw 目前来看是 Win 的最多。其实对于 Qt 来说，Win 和 Linux 的体验是差不多的，Mac 我没有机器，所以就没怎么用。我现在一般是在家用 Linux 开发，在公司用 Win 使用。所以 Win 的是没问题的，放心吧~ :) 谢谢！

[wzw]

@tamlok 我这会刚下载，试用以后 提出建议。 我猜，实时预览 还是不少人想要的。毕竟需要脑补效果，很麻烦的。 多一个选择嘛

[tamlok]

@wzw 其实基本不用怎么脑补~不过实时预览对新手比较友好，对于写 MD 熟到烂的童鞋来说基本不怎么需要。后面可以加一个简单的、可选的预览界面吧。:) 欢迎反馈！

[jin7]

可以直接那 vscode 或者 atom 当笔记本. 跨平台.
直接打开笔记本文件夹.
我现在就是这样子做的.
以前用为知笔记, 后来收费就转投 vscode 做 markdown 笔记了.
而且可以安装第三方 markdown 插件增强功能.

[tamlok]

@jin7 使用 VNote 后说不定您会感觉到专有优化的不一样 :) 我之前是使用 Vim 来记 Markdown 笔记的，后来觉得不好用，就写了 VNote。VNote 也是基于文件夹的形式，一个笔记本对应一个文件夹，笔记本里面每个子文件夹都有一个 json 配置文件，自给自足，所以这个笔记本根目录可以随便移动，比如同步到别的电脑上，然后再作为笔记本导入到 VNote 中。我以前也是为知笔记，后来在收费前夕本来打算开发 VNote 作为其中的一个客户端的，但是后来收费了，就先作罢了。

[wangleineo]

已 Star。开发了 9 个月，有恒心！
为什么用 Qt ？不用 html+js 包一个壳呢？是有什么功能用那种方式不好做吗？

[tamlok]

@wangleineo 谢谢！因为 CMD 作业部落的客户端就是包的一层 Web，多个文件来回切换的时候，慢到无法忍受，所以就不用它了。其实，主要是 C++比较熟悉～不过，现在 VNote 里面 Markdown 转 HTML 啥的都是用 JS 的，使用 QWebEngine 来实现 C++和 JS 的对接。JS 的确是比 C++的方便不少！

[yidinghe]

支持楼主，我已经受够了那些 electron 开发的笔记，开启速度慢，内存占用多，不好用。

[Immortal]

没有 linux 很伤心

[tamlok]

@Immortal Linux 目前需要自行编译～我开发是在 Linux，但是 Linux 的打包我现在暂时搞不懂呀～～您是哪个发行版的？后面我弄好打包后，再通知您来试一试～昨天刚给 Deepin 的社区提申请，说是会收录到商店里面。谢谢～

[tamlok]

@yidinghe 谢谢支持～

[Immortal]

@tamlok 谢谢 我用的是 linux mint18 基于 ubuntu 的 16.0.4 到时候 @我就行 我可以帮忙测试

[billion]

你不应该用 Qt 来写的。你知道 MarkEdit 吗？它也是用 Qt 写的，遇到了不能客服的障碍，开发者已经使用新的平台进行重写了，完全放弃基于 Qt 进行迭代了。

[tamlok]

@billion 搜不到 MarkEdit，只搜到一个 MarcEdit ～请问是什么不能克服的障碍呢？目前来看还行，的确某些功能是缺失，比如 WebEngine 打印啥的，5.7 还不支持，5.8 支持了。现在我遇到比较难实现的功能，都是使用 JS 来实现了，比如编辑时代码块的语法高亮啥的。很好奇那个障碍是啥，您想起来了记得告诉我一声哈～谢谢！

[billion]

MarkEditor->http://markeditor.com/app/markeditor
Qt 框架的问题->http://markeditor.com/docs/markeditor-updates.txt

[SuperMild]

@billion 原文说的是“副作用”，会不会是收费的原因？ Qt 做收费软件要交版权费

[billion]

我做了一个一键上传图片到图床，并自动将复制到剪贴板的项目，楼主有没有兴趣集成到你的这个项目中？
地址->https://github.com/kingname/MarkdownPicPicker

[billion]

@SuperMild 这就不知道了。

[jihaiming]

vim 模式赞一个....

[tamlok]

@billion 这个不清楚了，好像没有太多的说明。不管了，已经上船了哈～:)

[tamlok]

@jihaiming 谢谢～ Vim 模式是自己手动实现的，目前还不支持宏和.重复语法，感觉再做就等于做一个简单的 GVim 了～当然该有的都有了，可以参考软件的帮助说明，比如寄存器、标记、位置跳转、f/t 等都支持了。

[tamlok]

@billion 先标记一下，后面做到这块的时候看看能不能集成进去。目前 VNote 是自动插入图片到一个本地文件夹中，和笔记同一个目录。谢谢！

[abbatuu]

支持！期待有安卓版本

[tamlok]

@abbatuu 安卓板目前来看可能就有点力不从心了～后面会对接其他编辑器或笔记，比如为知笔记、印象笔记、StackEdit 等，从而利用它们的移动客户端。谢谢～

[SuperMild]

Captain Mode 好用啊！各种快捷键也设计得非常好

[tamlok]

@SuperMild 谢谢～您是第一个赞赏 Captain Mode 的～是模仿 Vim 的一个 EasyMotion 插件的。我比较常用的快捷键是 Ctrl+Num 插入标题，Ctrl+B/I/O 加粗 /斜体 /行内代码，Ctrl+W/U/H 删除词 /句 /字符等等。谢谢～～ Captain Mode 是我想到的一个将 EasyMotion 应用到窗口上，被认可好高兴呀～

[realwangyibo]

能入驻 homebrew cask 就更好了

[tamlok]

@realwangyibo 目前 Mac 上的因为我没有机器，都是在虚拟机里面测试的，刚才又修复了一个 Command+Q 退出程序会 Crash 的问题。可以下载 DMG 文件直接打开使用。等慢慢稳定了，后面可以看看怎么和 homebrew 那边接入。谢谢关注！

[wzw]

@jin7 pycharm 也不错

[Tyrion]

@tamlok 支持 UML 点赞！

[muyege]

只用 Typora

[tamlok]

@muyege Typora 在消除 md 的阅读编辑割裂感上走的是另一个极端。很多从 typora 入手的童鞋后来对于 md 语法基本不会越来越熟悉。VNote 是一个有良好编辑体验的笔记软件，和 typora 也不完全重叠。:)谢谢

[lp380490944]

对于不是很熟练 markdown 语法的小白来说预览还是很有必要的。

[tamlok]

@lp380490944 所以慢慢戒奶吧。。。之前有打算用一个小窗口预览当前光标所在处的内容，称为棱镜，不过还没实现。:)

[linxy]

我推荐一个小书匠+其它笔记软件（为知，有道云，印象，网盘）
小书匠 markdown 不要太舒服

[tamlok]

@linxy 小书匠也很不错，之前用过一段时间。后来就是不想一边书写一边预览，所以弄了一个 VNote。将来 VNote 也是要接入其他笔记服务的。谢谢~

[linxy]

@tamlok 你把预览关了不就行了…还是说要做成 typora 那样？

[tamlok]

@linxy typora 是另一个极端，我想要一个折中的方案。编辑的时候该加粗的加粗，斜体的斜体，代码块要高亮，图片链接要原地预览显示，公式要原地预览显示。一般的编辑器把预览关了就看不到代码块语法高亮和图片之类的，和纯文本编辑差不多了，我觉得还不够方便。

[copriwolf]

我记得有一个 app 叫做 haroopad 也是支持 vim 的，算是为数不多的支持 vim 客户端，支持一个

[tamlok]

@copriwolf 谢谢！ haroopad 只是一个编辑器，当初也用过一段时间，好像不支持多个标签页。Vim 花了将近两周时间实现，都麻木了，各种按键和状态处理。可惜目前还不支持.重复操作。宏估计就不打算支持了。:)

[muyege]

@tamlok 谢我干嘛?

[tamlok]

@muyege 礼貌性用语被提出来就尴尬了。。。谢谢你的回复吧

[muyege]

@tamlok 好嘞

[tkisme]

@tamlok caskroom 里面最好考虑添加一下

[ExploreWay]

不错，楼主水平挺强的。应该多向你学习。

[tamlok]

@tkisme2013 mac 我目前因为没机器，测试得比较少，都是在虚拟机里面搞的。后面我尝试一下怎么和 homebrew 或 cask 这些对接(其实我不知道这两个是不是同一个东西)。谢谢！

[tamlok]

@ExploreWay 哪里，就是一个搭积木的过程。期待更多的交流和反馈！谢谢！

[bao3]

这是开源软件，需要大家提交代码改进，结果你们全是在提 issue 让作者一个人改进。如此下来这个项目又废了。
另外那些 Mac 要提交 homebrew 的，自己做这件事也是可以的，而且作者没有必要去花精力提交到 homebrew，把精力用在改进就可以了。因为对 Mac 来说，有没有 homebrew /macports 都是那么回事，跟直接 dmg 没有任何差别。

[itfanr]

难得 感谢分享

[tamlok]

@bao3 哈，提 issue 这个倒没啥，我自己在用的话就会慢慢改进和完善这个软件。只不过一个人写的话，某些特性大家得耐心等一等。想法很多，实现有点慢哈！现在看到那么多人支持和认同这个项目，我真的受宠若惊！不过，Linux 和 mac 打包发行啥的，如果有人能够帮忙或指导一下就最好不过了，毕竟我不擅长这个。之前花了两天尝试在 Ubuntu 下打包 deb，但因为 Ubuntu 的 qt 版本低和其他一些依赖问题失败了。前两天向 Deepin 请求帮助，那边说是准备收录商店，这个社区还挺友好的。实在不行，我过段时间把那台烂电脑换硬盘复活后，会装各种发行版，再尝试一下打包。mac 下的交互逻辑有点特立独行，我也没有充分使用过，如果大家在使用过程中遇到什么不顺手的(比如 tab 改变输入焦点之类)，也希望多反馈。谢谢您的关注和支持！也谢谢评论和收藏这个主题的所有人！

[tamlok]

@itfanr 谢谢一路支持！😁

[clino]

linux 下编译怎么做啊

Cannot find file: /opt/vnote/hoedown/hoedown.pro.
Makefile:33: recipe for target 'hoedown//Makefile' failed
make: *** [hoedown//Makefile] Error 2

我已经在 vnote 下 clone 了 hoedown 了

[tamlok]

@clino Hi, 您执行`git submodule update --init`了吗？按照这里的报错，hoedown 下应该是没有文件。不需要额外去 clone 原来的那个 hoedown 仓库的。hoedown 作为 VNote 的子模块，我已经修改过了。正常流程是 clone 了 VNote，然后在 VNote 下执行`git submodule update --init`，这样就会自动把 hoedown 下载下来，然后才是 qmake 和 make 以及 make install。您再试试看？实在不行可以 QQ 群或者 Issue 详细讨论。谢谢使用！

[mianju]

支持一下 Latex 吧> <

[tamlok]

@mianju 是指 MathJax 数学公式吗？如果是这个，现在已经支持了。如果是只完整的 Latex 语法，这个估计很有难度，而且怎么和 Markdown 结合呢？谢谢！

[clino]

@tamlok 在 ubuntu 下有哪些依赖包要装?
我看好像是用 qt4,于是用了 sudo apt-get install qt4-qmake libqt4-dev
但是又出了 ../../src/vdirectory.h:8:23: fatal error: QJsonObject: No such file or directory 这个错,google 了下好像说要用 qt5

所以到底是 qt4 还是 qt5? 能不能为 ubuntu 专门写一段 install 说明呢?

[tamlok]

@clino Hi，是 Qt5.7,Ubuntu 的官方源可能还没有这么新的版本；在 Github 主页的 README 里面有一小节是关于 Linux 编译和安装的 （ https://github.com/tamlok/vnote#build--development-构建与开发），您可以参考一下。建议到 Qt 官方网站下载一个 Qt （*.run 格式，类似于绿色文件，安装好后打开 QtCreator，导入项目即可编译； 5.7/5.8/5.9 版本都可以），比较方便。Ubuntu 的软件更新慢是一个问题～～

[tamlok]

@clino 上面的网址重新回复一下： https://github.com/tamlok/vnote#build--development-构建与开发

[xiaoz]

我新建笔记怎么是灰色的，有遇到的吗？ https://i.bk.tn/uploads/1706/270804001896.png

[tamlok]

@xiaoz 您好！因为 vnote 遵循笔记本-文件夹-笔记的层次，所以接下来您应该先新建一个文件夹，然后就可以新建笔记了。可以用鼠标放在工具栏上各个按钮看看，有工具提示的。谢谢使用！

[xiaoz]

@tamlok 谢谢解答，已经解决这个问题了。

[tamlok]

@xiaoz 期待使用反馈！:)

[clino]

@tamlok 正在安装 qt 开发包,过了好久都没下载完...
有点醉了...太费劲了

[hjdtl]

我做了个在线实现编译的 md to html

[tamlok]

@clino sorry，自行编译是有点麻烦。主要还是 ubuntu 的 qt 太旧了。或者您可以等后面 VNote 打包后再来尝试。:)Linux 下的 Qt 安装包只有 1G，是三个平台里面最小的了，真心希望能等它下载完哈！

[tamlok]

@hjdtl 赞！这个感觉更有难度。VNote 直接找网上现成开源的轮子了，目前默认的是 markdown-it。

[tamlok]

@clino 安装好后，基本就可以编译所有 qt5 写的程序啦