e1bece6378b9794c9f71ca3d76b4770fbb722e28
主题 - 新增「按时段自动」模式:6:00–18:00 浅色,其余时间深色 - 主题菜单改为四种模式,默认仍为跟随系统 侧栏 - 左侧文件夹侧栏(Ctrl+B 开关),递归扫描 *.md / *.markdown / *.mdown / *.mkd - 文件 → 打开文件夹…(Ctrl+Shift+O),记住上次打开的目录 - 点击文件名即打开,当前文件在列表中高亮,支持手动刷新 编辑 - 左下角 <src> 按钮 / Ctrl+Shift+M 切换源代码模式(关高亮、行号、当前行) - Ctrl+1~6 设置标题级别,再按一次取消 - Ctrl+/ 把选中内容包成围栏代码块,再按一次拆掉(含光标在块内的情况) 其他 - 模板回归脚本验证了标题与代码块的文本变换 - README 与截图更新
VoiletMark
一个轻量的跨平台 Markdown 编辑器,基于 Qt 5 / C++17 构建。
当前版本 0.2.0。
界面
| 浅色 | 深色 |
|---|---|
![]() |
![]() |
左侧是文件夹侧栏,递归列出目录里的所有 Markdown 文件,点一下就切换。
功能
编辑
- Markdown 语法高亮:标题、粗体 / 斜体 / 删除线、行内代码、围栏代码块、 链接与图片、引用、有序 / 无序列表、任务列表、分隔线
Ctrl+1~Ctrl+6把选中行设成 1–6 级标题,再按一次变回正文Ctrl+/把选中内容包成围栏代码块,再按一次拆掉- 行号栏、当前行高亮
Tab/Shift+Tab整行缩进,选中多行时批量缩进- 自动换行(
Alt+Z)、Ctrl+滚轮或Ctrl++/Ctrl+-缩放字号 - 撤销 / 重做、剪切 / 复制 / 粘贴,菜单项会跟随可用状态自动灰显
- 把 Markdown 文件直接拖进窗口即可打开
文件夹侧栏
- 文件 → 打开文件夹…(
Ctrl+Shift+O)选一个目录,递归扫描*.md/*.markdown/*.mdown/*.mkd Ctrl+B显示 / 隐藏侧栏- 点文件名即打开,当前文件在列表里高亮;右上角「刷新」重新扫描
- 上次打开的文件夹会被记住,下次启动自动恢复
源代码模式
左下角状态栏的 <src> 按钮(或 Ctrl+Shift+M)切到源代码模式:
关掉语法高亮、行号与当前行高亮,只显示文件原始内容,适合核对格式或复制纯文本。
默认是编辑模式,按钮会显示成 </src> 表示当前处于源码模式。
文件
- 新建、打开、保存、另存为、最近打开(最多 8 条)
- 保留原文件的 BOM 与 CRLF 换行风格,保存时原子写入(
QSaveFile) - 关闭或切换文件时提示未保存的修改
- 记忆窗口位置、字号、换行开关、侧栏状态等设置
主题
四种模式:
| 模式 | 说明 |
|---|---|
| 跟随系统(默认) | 读取桌面环境的浅色 / 深色设置 |
| 浅色 | 固定浅色 |
| 深色 | 固定深色 |
| 按时段自动 | 6:00–18:00 浅色,其余时间深色 |
跟随系统时每 2 秒检测一次,改动后整套界面立即重绘:
| 平台 | 检测方式 |
|---|---|
| Windows | 注册表 AppsUseLightTheme |
| macOS | defaults read -g AppleInterfaceStyle |
| Linux | gsettings color-scheme / GTK 主题名 → KDE kdeglobals → XFCE xsettings.xml → 调色板兜底 |
模式可在 视图 → 主题 中切换,选择会被记住。
构建
依赖:Qt 5.12+(含 Widgets 模块)、支持 C++17 的编译器。
Qt Creator(推荐)
- 用 Qt Creator 打开根目录的
VoiletMark.pro - 在 项目 → 构建设置 中选好本机的 Qt 5.15.2 套件(Kit)
Ctrl+R直接运行
Qt Creator 默认走影子构建(shadow build),不会污染源码目录。
命令行
mkdir -p build && cd build
$HOME/Qt5/5.15.2/gcc_64/bin/qmake ../VoiletMark.pro
make -j"$(nproc)"
./VoiletMark
或者直接:
./scripts/build.sh
脚本会依次查找 command -v qmake、$QT_PREFIX/bin/qmake、
$HOME/Qt5/5.15.2/gcc_64/bin/qmake;也可以用 QMAKE=/path/to/qmake 直接指定。
命令行
VoiletMark # 打开编辑器(显示欢迎文档)
VoiletMark notes.md # 直接打开指定文件
VoiletMark --theme dark # 本次运行使用深色主题(system / light / dark / schedule)
VoiletMark --screenshot a.png # 渲染窗口截图后退出(调试 / 视觉回归)
快捷键
| 快捷键 | 功能 |
|---|---|
Ctrl+N / Ctrl+O / Ctrl+S |
新建 / 打开 / 保存 |
Ctrl+Shift+S |
另存为 |
Ctrl+Shift+O |
打开文件夹 |
Ctrl+B |
显示 / 隐藏侧栏 |
Ctrl+Shift+M |
源代码模式 |
Ctrl+1 ~ Ctrl+6 |
设为 1–6 级标题(再按取消) |
Ctrl+/ |
代码块(再按拆掉) |
Ctrl+Z / Ctrl+Shift+Z |
撤销 / 重做 |
Ctrl+滚轮、Ctrl++、Ctrl+-、Ctrl+0 |
缩放 / 恢复字号 |
Alt+Z |
切换自动换行 |
Tab / Shift+Tab |
缩进 / 反缩进 |
Ctrl+Q |
退出 |
代码结构
src/
├── main.cpp 入口:命令行解析、Fusion 样式、主题初始化
├── ThemeManager.{h,cpp} 四种主题模式 + 系统检测 + 调色板 / QSS 生成
├── MainWindow.{h,cpp} 菜单、文件读写、文件夹侧栏、状态栏、设置
├── MarkdownEditor.{h,cpp} 编辑器控件:行号、缩进、标题 / 代码块命令、源码模式
└── MarkdownHighlighter.{h,cpp} Markdown 语法着色(含围栏代码块状态机)
下一版计划
- 实时预览(右侧或同屏渲染)
- 查找 / 替换
- 列表按回车自动续行
- 表格与数学公式支持
- 导出 HTML / PDF
Languages
C++
91%
Shell
3.6%
Python
2.6%
NSIS
2.1%
QMake
0.7%

