Notepad--:5分钟搞定Markdown实时预览
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
写文档写了一半,想看效果还得切到浏览器里刷新,来回三趟,够烦的。Notepad-- 把 Markdown 预览做进了编辑器本身:打开文件,右键,就能看到渲染结果。下面带你从拉代码走到第一次预览渲染。
Notepad--(内部叫 ndd)是位国内开发者维护的跨平台文本编辑器,GPLv3 协议开源,Windows、Linux、macOS 都能跑。它定位是给 Notepad 类软件做国产可替代,重点照顾 UOS 和各类 Linux 环境。对写 Markdown 的人来说,它最实在的一点是:预览不用装插件,不用本地搭渲染环境,编辑器自己就能渲染。
Notepad-- 软件信息窗口-显示GPLv3开源协议与版本
🚀 把代码拉下来
仓库克隆到本地:git clone https://gitcode.com/GitHub_Trending/no/notepad--
仓库根目录带了一份编译说明.docx,按你所在的平台照做即可。依赖主要是 Qt5 环境和一个 C++ 编译器,没有别的额外负担。
让它认出 .md 文件
程序内置了 Markdown 的词法分析器,双击一个.md文件,自动识别并做语法高亮。扩展名对不上的纯文本,就在语言菜单里手动选 Markdown。
打开那个预览窗
编辑区任意位置右键,菜单里选Markdown View。一个子窗口弹出来,把当前文件的内容渲染出来。之后你每敲一个字,预览都跟着同步刷新。
Notepad-- 编辑器主界面-目录列表与多标签代码编辑
你敲什么,屏幕上出现什么
敲一行# 一级标题,右边出现大号加粗的标题;敲几条- 项目,变成带符号的列表;用三个反引号包住几行代码,得到一个高亮的代码块;写表格、加粗、链接,也都直接生效。说白了,它就是把 Markdown 文本喂给 Qt 的渲染器,预览窗格里的QTextEdit调一次setMarkdown(),文本就变成渲染好的 HTML 直接显示。
预览窗是主编辑器的顶层子窗口:能拖、能缩放,甩到第二块显示器上也不影响主界面布局。编辑区保持干净,长文档写作时,人在代码屏、预览放旁边,比来回切窗口舒服得多。
想瞄一眼实现,入口只有一行:预览窗本体在 src/markdownview.cpp,触发菜单和实时刷新的挂钩都在 src/scintillaeditview.cpp。
多文档并行预览
Notepad-- 多标签编辑界面-多个文档标签页并行打开
写东西经常一次摊开好几个相关文档。Notepad-- 的多标签把.md文件并排放着,每个标签页的预览窗各自独立,互不串味。
🎨 改一行 QSS 换预览皮肤
如果默认预览窗的底色不合眼,去src/qss/目录改common.qss。预览区本质是个只读QTextEdit,在样式表里给它定背景色、字体、行距就行,重新编译启动,新皮肤生效。
如果你边写代码边写文档
编辑区的语法配色由src/themes/下的主题控制,每种语言一套配色文件。挑一套顺眼的,写码和写文档切换时眼睛不容易累。
如果你经常写长文档
到设置里把自动保存打开。预览窗一直开着刷新,中途就算意外退掉,进度也不丢。
预览窗一片空白
大概率是编码问题。文件不是 UTF-8 时,解析出来可能就是空的。右键把文件转成 UTF-8 编码,预览基本就恢复了。
敲字时预览不动
更新链路是在预览窗第一次弹出时才挂上的。关掉预览窗,重新选一次Markdown View,同步就回来了。
表格错位、代码块显示成原文
渲染器是 Qt 内置的,个别扩展语法不在支持范围内。把写法收敛到标题、列表、代码块这些基础语法,渲染就稳定了。
浏览器和编辑器之间的来回粘贴,到此为止。拉个仓库,右键就能预览;踩到坑,直接去仓库提 issue。
【免费下载链接】notepad--一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。项目地址: https://gitcode.com/GitHub_Trending/no/notepad--
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考