notepad-- Markdown 预览完整指南:边写边渲染,告别来回切换
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
写技术文档时总想在编辑器和浏览器之间来回切换确认效果?notepad-- Markdown 预览直接把渲染结果放进一个独立窗口:边写边看,标题、列表、代码块即写即现,不装插件、不配环境。📝
场景引入
上周整理项目 README,我反复要回头检查表格对齐、代码块缩进和标题层级——每改几行就得开一次浏览器预览器,耐心很快就磨没了。
在 notepad-- 里这件事一步完成:打开.md文件,右键调出预览窗口,之后编辑器里每敲一个字符,预览窗口都跟着更新。眼睛只需要盯渲染后的结果,手不用离开键盘。
三步开启 notepad-- Markdown 预览
- 打开任意
.md文件,或从菜单语言(L) → Markdown手动指定语言,让编辑器识别格式。 - 在编辑区右键,点菜单里的Markdown View,独立预览窗口立即弹出。
- 继续在编辑器里写,内容一变预览自动刷新,无需手动"重新加载"。
提示:预览窗口与当前标签页绑定,切换标签后再打开预览,显示的就是对应文件的内容。
核心能力拆解
边写边看:实时同步渲染
编辑器会监听文本变更事件,每次改动都立刻把最新全文推给预览窗口。核心实现就一行:
ui.textEdit->setMarkdown(text)
这一句调用 Qt 内置的 Markdown 解析器,把原文转成富文本展示。完整实现可以看 预览窗口源码,触发逻辑在 编辑视图。
notepad-- Markdown 预览的同步编写工作区
零配置:内置 Markdown 解析
不依赖任何外部组件,常见语法开箱即用:
- 标题、加粗/斜体、有序无序列表、引用
- 行内代码与代码块
- 链接、表格
独立窗口,随意摆放
预览窗口是一个独立主窗口,行为很省心:
- 能单独拖出来扔在副屏,主屏继续写
- 可自由缩放,不影响正在编辑的文件
- 关掉只关窗口,文件原封不动
跨平台体验一致
Windows、Linux、macOS 上交互完全相同。下图是 macOS 版本的编写工作区,右侧随时可调出预览:
进阶玩法
- 想换预览窗口的字体和底色?可参考现成样式文件 src/qss/mystyle.qss,其中 QTextEdit 的 QSS 写法可直接借鉴。
- 特别长的文档,每次击键都全量重渲染会有点吃力,建议集中编辑时先关预览,需要检查时再调出。
- 到设置(S) → 快捷键管理给Markdown View绑一个顺手的快捷键(比如
F12),单手随时调出预览,实现见 src/shortcutkeymgr.cpp。 - 预览搭配语法高亮更好用:先语言(L) → Markdown点亮高亮,源码、渲染结果都清爽。
避坑指南:notepad-- Markdown 预览常见问题
| 现象 | 原因 | 解法 |
|---|---|---|
| 预览窗口一片空白 | 当前标签是空文件,或切到空标签后调出 | 切回有内容的 Markdown 标签再右键打开预览 |
| 预览内容不更新 | 预览绑定当前标签,你正在编辑的可能是另一个标签 | 确认活动标签后重新打开预览 |
.md文件没有语法高亮 | 语言未被自动识别 | 手动指定语言(L) → Markdown |
| 超长文档编辑卡顿 | 预览每次击键全量重渲染 | 编辑时关闭预览窗口,需要时再开 |
| 关掉后预览"丢了" | 窗口随关闭销毁,属正常设计 | 再点一次Markdown View即可重建 |
写在最后
notepad-- Markdown 预览把"写文档 → 看效果"从两个窗口压缩成一次右键,效果永远在你眼皮底下。如果它合你的工作流,去仓库点个 Star 支持一下;遇到渲染不对的地方,直接在 Issue 区反馈,我们会尽快跟进。✅
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考