MDRE for VS Code
MDRE for VS Code 当前版本为 0.2.2。提供 Markdown 源码与富文本的双向编辑功能,可直接修改富文本,也可显示源码栏进行编辑;两种视图保持同步。
功能
- 双向编辑:Markdown 源码与富文本编辑器同步;保存、自动保存、撤销和重做使用 VS Code 原生文档机制。
- 格式与结构:单行工具栏按类别分组,窄窗口可横向滚动;工具栏和右键菜单支持标题、列表、引用、链接、表格、下划线、颜色、高亮、上下标等。下划线使用通用 HTML
<u>内容</u>。
- 公式与图表:KaTeX 渲染数学公式,MathLive 可视化编辑;支持 Mermaid 图表。
- A4 阅读与编辑:连续或分页排版,Ctrl+滚轮缩放 25%–250%;分页按可用宽度每行显示 1–3 页,并显示页码。
- 侧栏与大纲:按标题层级导航,条目保持原有高度,内容超出可用区域时可滚动查看;可折叠大纲、收起侧栏或拖动调整宽度。
- 可配置排版:字体、字号、行距、主题、分页正文对齐、图片显示方式和侧栏宽度。图片默认适应正文宽度,代码块支持浅色或深色主题。
- HTML 与 PDF 导出:嵌入本地图片及公式字体;PDF 导出调用系统 Edge 或 Chrome。
打开 Markdown
- 打开
.md 或 .markdown 文件。
- 在命令面板运行 MDRE: 打开双栏编辑器,或右键文件选择同名命令。
- 也可以使用 重新打开编辑器方式 → MDRE 双栏编辑器。
本扩展保留 VS Code 原生 Markdown 编辑器;默认不将 MDRE 设为 Markdown 文件的默认编辑器。
常用操作
| 操作 |
方法 |
| 显示/隐藏源码 |
视图组中的分栏图标 |
| 收起/展开侧栏 |
视图组中的侧栏图标,或 Ctrl+Shift+O |
| 大纲导航 |
点击标题跳转;条目较多时滚动查看,标题旁箭头折叠/展开列表 |
| A4 与分页 |
A4 图标;设置 → 纸张与图片 → A4 排版方式 |
| 纸张缩放 |
在渲染栏按住 Ctrl 并滚动鼠标滚轮 |
| 下划线 |
字体组 U 按钮、Ctrl+U 或右键菜单 |
| 编辑公式 |
双击公式 |
| 编辑 Mermaid |
双击图表并修改源码 |
| 帮助 |
设置 → 帮助 |
扩展默认隐藏源码栏;设置中的“默认显示源码栏”可改变这一行为。
插入的图片保存至已保存文档所在目录的 assets/;使用前请先保存 Markdown 文件。文件夹、文件标签和启动恢复使用 VS Code 原生工作区机制。详细操作方法可在“设置 → 帮助”中查看。
PDF 导出
需要系统安装 Microsoft Edge 或 Google Chrome。自动检测失败时,在 VS Code 设置中填写 mdre.pdf.browserPath。扩展不会下载 Chromium。
运行要求
扩展要求 VS Code 1.95.0 或更高版本。
许可证
本项目使用 MIT 许可证。第三方组件及字体的版权和授权文本随包保留;在“设置 → 帮助”中选择“MDRE声明”,可查看清单和原文。
GitHub
项目地址:MDRE for VS Code
| |