Files

T

liyepan e1bece6378 feat: v0.2.0 —— 文件夹侧栏、源代码模式、按时段主题与格式快捷键

主题
- 新增「按时段自动」模式：6:00–18:00 浅色，其余时间深色
- 主题菜单改为四种模式，默认仍为跟随系统

侧栏
- 左侧文件夹侧栏（Ctrl+B 开关），递归扫描 *.md / *.markdown / *.mdown / *.mkd
- 文件 → 打开文件夹…（Ctrl+Shift+O），记住上次打开的目录
- 点击文件名即打开，当前文件在列表中高亮，支持手动刷新

编辑
- 左下角 <src> 按钮 / Ctrl+Shift+M 切换源代码模式（关高亮、行号、当前行）
- Ctrl+1~6 设置标题级别，再按一次取消
- Ctrl+/ 把选中内容包成围栏代码块，再按一次拆掉（含光标在块内的情况）

其他
- 模板回归脚本验证了标题与代码块的文本变换
- README 与截图更新

2026-10-22 17:20:17 +08:00

4.8 KiB

Raw Blame History

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

4.8 KiB Raw Blame History Unescape Escape