[发布] 在 VS Code 写 Org-mode 的简单预览扩展,欢迎试用和反馈

:link: 链接


由于我越来越依赖 Cursor 的 AI 功能进行日常开发,因此希望在 VS Code/Cursor 中实现 org-mode 的顺利编辑能力。这就是我开发 VOrg 的初衷——在 org-mode 强大的笔记结构与 Cursor 提供的现代 AI 辅助编辑体验之间搭建桥梁。最近把自己用来写笔记的小工具整理成了一个 VS Code 扩展:VOrg。它不是要"复刻" Emacs 的 Org-mode,而是尽量在 VS Code 里把常用的基础功能做得可用、顺手,重点放在预览体验和一些 org-like 的编辑辅助上。相比 Emacs 中的 org-mode,VOrg 的一个优势是提供了实时预览和预览窗口跟随编辑器滚动的功能,让编辑和预览体验更加流畅。发出来给也在 VS Code 写 Org 的朋友看看,欢迎随便试用、提意见,别客气。

:sparkles: 它能做的

  • 实时预览 + 滚动同步:编辑器和预览窗口同步滚动

  • 语法高亮:标题、TODO、列表、表格、代码块、链接、时间戳等

  • 文档大纲:自动解析结构,提供完整的 Outline 导航

  • 链接跳转:支持多种链接类型(id: 全局ID、文件链接、网页链接、同文件标题跳转等)

  • org-like 编辑功能

    • 智能 Meta Return(上下文感知插入)

    • Tab 智能折叠(标题、列表、代码块、Property 抽屉等)

    • Property 抽屉管理

    • TODO 状态切换

    • TODO 关键字可配置(支持 @/! 记录)

:cross_mark: 它暂时不做的

  • 不追求完全还原 Emacs Org-mode 的所有行为和快捷键

  • 高阶工作流(refile、复杂 agenda、树操作等)还在路线图里

:bullseye: 可能适合

  • 日常在 VS Code 里写 .org 文件,想要一个够用的预览和基础编辑体验

  • 偶尔需要从 Emacs 之外快速浏览/编辑 Org 文档的场景

:red_question_mark: 可能不适合

  • 重度依赖 Org-mode 完整工作流的同学(因为实现还比较“克制”)

:keyboard: 几个常用的快捷键

  • 预览Ctrl+C Ctrl+E(类似 Emacs C-c C-e

  • 跟随链接Ctrl+C Ctrl+O(类似 Emacs C-c C-o

  • 插入 TODO 标题Shift+Alt+Enter

  • 切换 TODO 状态Ctrl+C Ctrl+T(类似 Emacs C-c C-t

  • 智能插入新元素(Meta Return):Alt+Enter 和 (Ctrl Return):Ctrl+Enter

  • Tab 折叠/展开Tab / Shift+Tab

:test_tube: 欢迎反馈

这是个人项目,测试场景有限。如果你在使用过程中遇到问题、有改进建议,或者发现 bug,欢迎:

所有反馈都会认真查看和处理!


如果你日常中主要是 VS Code 系的 IDE,那么希望能帮助你实现在 VS Code 中写 .org 文件的顺畅体验。如果不合适,也请随手告诉我哪里不顺手。我会根据反馈持续改进。谢谢!

5 个赞

希望能增加“预览并保存为 HTML”的功能,并支持通过 CSS 进行渲染。

非常感谢!

已支持 html 预览导出

同时预览页面也添加了导出按钮

自定义 css 暂时不支持,有空我再处理吧

1 个赞