Live Markdown with Outline
在 VS Code 中打开 Markdown，即可直接编辑渲染后的文档——无需在源码、预览、双栏之间来回切换。左侧或右侧常驻可折叠大纲，点击标题即可跳转。
为什么用它
打开即写：.md 文件默认进入 Live 模式，标题、列表、表格等即时呈现
大纲始终在线：树形目录支持折叠、跳转、右键批量展开/折叠
仍是标准 Markdown：磁盘上保存的是普通 .md 文本，Git diff 与外部工具完全兼容
主要功能
| 功能 |
说明 |
| Live 即时渲染 |
基于 Milkdown 的 WYSIWYG 编辑体验 |
| GFM 支持 |
表格、任务列表、删除线、引用、代码块等 |
| 语法高亮 |
TypeScript、Python、JSON、Shell 等常见语言，配色跟随编辑器主题 |
| HTML 嵌入 |
支持内嵌 HTML（如 HTML 表格）渲染 |
| Mermaid 图表 |
```mermaid 代码块渲染为流程图、时序图等 |
| 大纲侧边栏 |
可拖拽调整宽度，支持「展开到第 N 级」 |
| 相对路径图片 |
文档目录下的本地图片自动解析 |
| Git 友好 |
保留 VS Code 原生 diff 能力 |
快速开始
- 安装扩展并重载窗口（Developer: Reload Window）
- 在资源管理器中打开任意
.md / .markdown / .mdx 文件
- 默认即进入 Live 编辑器；大纲出现在编辑区左侧（可在设置中改到右侧）
从 VSIX 安装
cursor --install-extension live-markdown-with-outline-1.0.10.vsix --force
安装后请重载窗口。扩展默认会将 Markdown 文件设为默认打开方式。
常用命令
Live Markdown with Outline: Open Editor — 用本扩展打开当前文件
Live Markdown with Outline: Set as Default Editor — 设为 .md 默认编辑器
Live Markdown with Outline: Unset Default Editor — 取消默认
设置
| 设置项 |
默认值 |
说明 |
liveMarkdownWithOutline.outline.position |
left |
大纲位置（left / right） |
liveMarkdownWithOutline.outline.width |
240 |
大纲宽度（160–480 像素） |
liveMarkdownWithOutline.outline.collapseItems |
expanded |
大纲树默认折叠状态 |
liveMarkdownWithOutline.useAsDefault |
true |
是否作为 .md 默认编辑器 |
liveMarkdownWithOutline.lineHeight |
1.6 |
编辑器行高 |
使用提示
Mermaid 图表：平时显示渲染结果；点击代码块进入编辑，修改后自动重新渲染。
HTML 表格：可直接在文档中插入 HTML，例如：
<table>
<tr><th>列 1</th><th>列 2</th></tr>
<tr><td>A</td><td>B</td></tr>
</table>
Cursor 说明：编辑区上方可能仍有 Preview / Markdown 切换栏，这是 Cursor 内置 UI，扩展无法隐藏。
扩展信息
| 项目 |
值 |
| 扩展 ID |
yuedong.live-markdown-with-outline |
| 发布者 |
yuedong |
许可证
MIT
| |
