我做了一个插件把 VS Code 的 Markdown,改成了更像 Obsidian 的所见即所得编辑器

如果你也长期在 VS Code 里写 Markdown,大概率会有一个很明显的痛点:
打开 .md 文件,迎面而来的是一屏源码——##、**、[链接文字](url) 全挤在一起。想看最终渲染效果,得再点一次”打开预览到侧边”;把预览塞到右边之后,编辑区和预览区挤在一块儿,长文写起来双眼不知道该盯哪边,思路总被打断。
这套工作流最大的问题,不是”不能用”,而是它把写作和阅读拆成了两件事——你永远在”编辑源码”和”切换预览”之间来回横跳。相比之下,Obsidian 的 Live Preview 就自然很多:你看到的基本就是最终结果,同时又可以直接编辑,写作流是连续的。
所以这次我自己做了一个开源插件,名字叫 Markdown WYSIWYG Editor,目标很直接:把 VS Code 里的 Markdown 编辑体验,往 Obsidian 那种所见即所得的方向拉近一步。


我到底想解决什么问题
我想解决的不是 Markdown”不能写”,而是默认体验的割裂感:
-
打开文件看到源码,不是阅读结果 -
想看效果还要手动点预览,多一步操作 -
左右分栏很挤,尤其不适合长文和知识库场景 -
图片、标题层级、表格这些内容,在编辑过程中缺乏直观反馈
如果你平时既写代码、又写文档、还顺手维护知识库,这种割裂感会特别突出。你明明只是想安静写点东西,却总在两种视图之间来回横跳。
这个插件现在能做什么
目前这个插件已经可以提供一套比较完整的 Live Preview 体验:
-
打开 Markdown,默认直接进入渲染态,不用手动触发 -
可以直接在渲染结果里原位编辑,不是只读预览 -
右上角一键切换 Raw Markdown/连续渲染两种模式 -
右侧提供可折叠、可收起的紧凑型大纲,长文导航用 -
支持本地图片显示 -
支持 Obsidian 风格图片嵌入语法 ![[image.png]] -
支持标题、段落、列表、任务列表、引用块、代码块、表格、分割线等常见 Markdown 结构
它的核心定位不是”左边源码 + 右边预览”那种老式双栏方案,而是让你在一个连续的单视图里完成阅读、修改和整理,就像在一个正儿八经的笔记软件里写东西一样。


这次重点打磨了哪些细节
做出基础”能渲染、能编辑”的功能之后,我专门补了一轮体验打磨,主要集中在三个方向。
第一类:排版密度。 块与块之间、段落与标题之间的间距,如果没有仔细调,读起来要么太松像展示用的,要么太挤像没处理过的。我重新调了整体的行距、段距和字号,让长文浏览时更接近笔记软件那种舒服的密度。
第二类:视觉风格。 整体方向是偏暗色的 Nord / One Dark,但我把颜色往更有层次的方向推了一些——标题、正文、代码、强调、链接在视觉上有明显区分度,避免了那种”所有东西都是同一种灰”的平淡感。
第三类:基础 Markdown 元素的渲染质量。 表格、分割线、图片、任务列表,这些如果做得”糙”,整个编辑器看上去就像个 demo。这次专门把这些基础元素的渲染规范重新整理了一遍,让它更接近一个真正可以长期使用的编辑环境。

两个我最喜欢的设计
一个是 Raw / 渲染切换。
没有人会永远待在同一种模式里。有时候你就想顺着文章往下写,呆在渲染态就行;有时候你需要做整段重构、调整列表结构,回到源码更高效。这个切换按钮的意义不是多一个功能,而是把”模式切换的成本”降到最低——一键,无缝,不打断写作节奏。
另一个是右侧大纲。
长文写作、知识库整理、本地文档维护,本质上都离不开结构导航。大纲如果做得太重,会抢戏;太弱,又失去价值。这次把它改成了更紧凑的样式,并且支持折叠和收起,更接近 Obsidian 那种”需要的时候随手可用、不需要的时候尽量隐身”的感觉。

适合谁用

这个插件比较适合下面几类人:
-
长期在 VS Code 里写笔记和文档的开发者——不想被预览窗格占屏幕 -
代码 + 知识库 + 内容输出三合一的人——一个编辑器里搞定所有写作需求 -
不想离开 VS Code 生态、但希望 Markdown 更顺手的人 -
喜欢 Obsidian 的体验、但工作主场仍然在 VS Code 的人
当然,它现在依然是一个可用原型,不是 Obsidian 的完整替代品。更复杂的嵌套列表、数学公式、Mermaid 图表等能力后面还可以继续补。但如果你的核心诉求是:打开 Markdown 先看到结果,并且能直接在结果上改,它已经足够值得一试。
已开源,可直接安装
项目已经放到 GitHub 上,也已经打好了可安装的 VSIX 发布包。
-
GitHub 仓库:summerchaserwwz/markdown-wysiwyg-editor -
Release 下载:v0.1.1
当前版本 0.1.1 已包含:
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|

最后
我一直觉得,Markdown 最大的价值不是”源码很优雅”,而是它应该成为一种低摩擦的写作介质——你不应该为了确认效果去额外切换视图,也不应该为了编辑内容一直盯着原始符号。
这也是我做这个插件的原因。
如果你也受不了 VS Code 里 Markdown 编辑时那种源码和预览割裂的感觉,可以直接拿去试试。后面我也会继续往更完整的 Obsidian 风格体验上打磨——更强的语法支持、更自然的连续编辑、更稳定的渲染细节。
如果你愿意,也欢迎提 Issue、提建议,或者直接一起改。
往期回顾
深度揭秘全网疯传的 Claude Code 泄漏源码:50万行代码里藏着什么?
我做了一个开源项目,计算你工作的牛马程度
Harness Engineering:AI时代最重要的工程范式
AI消极怠工?狂揽6k Stars的PUA Skill让你的AI停止摆烂
开源小工具|我做了个 GitHub 趋势和 Skill 热度探测器:AI 生态什么方向最火?
“ 大家好,我是小柴,C9计算机本硕,做过产品,现在是AI算法工程师,持续跟进和分享AI资讯、智能体、开源实测、经验分享、个人工具分享等内容,欢迎加好友进群交流,您的点赞、关注和分享是我持续创作的动力 🙏
夜雨聆风