v1.19.256

Fixed

• 链接导航支持文件名含空格 (%20 编码): 点击链接现在可以正常打开目标文件
  • 新增 LinkNavigation 模块封装 URL 解析逻辑，使用 removingPercentEncoding 解码 href 中的空格
  • 新增测试用例覆盖 %20 编码的各种场景
  • 新增 docs/debug/DEBUG_PERCENT_ENCODED_LINK_NAVIGATION.md 记录问题和排查过程
  • 添加测试 fixture 文件用于手工验证

v1.19.253

Fixed

• Mermaid sequenceDiagram participant 标签引号渲染: 修复 participant U as "用户（飞书）" 语法中引号被原样渲染到方块中的问题
  • Mermaid parser 不会自动剥除 as "..." 中的引号，导致用户看到 "用户（飞书）" 而非 用户（飞书）
  • 预处理函数新增 quote stripping 逻辑，在渲染前剥除 participant/actor alias 的引号
  • 同时支持带 \n 换行的 alias（如 participant X as "line1\nline2"）

v1.19.250

Fixed

• Sparkle 更新提示 Markdown 渲染: 修复更新提示界面中 **粗体** 等 Markdown 语法显示为原始星号的问题
  • scripts/generate-appcast.sh 新增 Markdown → HTML 转换逻辑
  • 支持 ### 标题 → <h3>、**粗体** → <strong>、`代码` → <code>、- 列表 → <ul><li>
  • 批量修复 appcast.xml 中历史版本的 description 格式
  • 更新 /publish 命令文档，明确说明 description 必须是 HTML 格式
• 帮助面板触发逻辑优化 (Issue #12): 修复 Cmd 长按触发功能指南时，在 Cmd+Tab、Cmd+Space、老板键等快捷键组合下误触发的问题
  • 新增修饰键检测：按下非修饰键（如 Tab、Space、字母）时立即取消 Cmd-hold 计时器
  • 仅纯 Cmd 长按（不按其他功能键）才会触发帮助面板

Added

• 帮助面板偏好设置: 新增复选框控制 Cmd 长按自动弹出功能
  • 用户可在帮助面板底部勾选/取消"按住 ⌘ 2 秒自动打开此面板"
  • 偏好设置持久化存储，重启后仍然生效
  • 仅 App 模式显示（QuickLook 模式下 Cmd 长按本来就不生效）

Changed

• 帮助面板 badge 逻辑修正: App 专属快捷键显示 "App" badge，两平台通用的功能不再显示 badge

v1.18.246

What's New

Added

• Mermaid node label line break support: AI-generated Mermaid diagrams often use \n inside double-quoted node labels to indicate line breaks (e.g. A["line1\nline2"]), but Mermaid renders them as literal characters by default
  • Added a pre-processor that automatically converts \n to <br/> HTML line breaks before rendering
  • Users no longer need to manually edit AI-generated documents to get correct line breaks
  • Works with all Mermaid diagram types (flowchart, sequence, class, etc.)

---

Install / Update:

brew update && brew upgrade --cask flux-markdown

Or download the DMG directly from the assets below.

v1.17.243

Fixed

• App 模式文件实时刷新: 修复用外部编辑器修改文档后 App 窗口内容不更新的问题
  • 使用 DispatchSource (kqueue) 监听文件变更事件 (.write/.delete/.rename)
  • 检测到变更后自动重新读取文件并触发重渲染
  • 兼容原子写入（先写临时文件再 rename）的场景
  • 通过 size + mtime 去重，避免无意义重渲染

v1.17.239

Added

• 功能帮助面板: 按 ? 键或点击右上角 ? 按钮显示完整的快捷键与功能指南
  • 区分 QuickLook 与 App 两种运行环境，显示不同的可用功能
  • QuickLook 环境显示黄色警告横幅，提示键盘事件被系统拦截
  • App 独占功能（导出、设置、检查更新）标记黄色 App badge
  • 两端都支持的功能标记蓝色 QuickLook + 黄色 App badge
  • 支持 ? 键、按住 ⌘ 2秒、点击 ? 按钮三种触发方式
  • 首次打开时显示 Toast 提示
• 多语言支持: 帮助面板支持中英文切换
  • Settings → Appearance → Language 选择 System Default / English / 中文
  • 默认跟随系统语言设置

v1.16.236

Added

• 链接状态栏: 鼠标悬停在链接上时，当显示文字与实际链接不一致，在窗口左下角显示实际链接地址
  • 支持 QuickLook 预览和主应用
  • 自动解码 URL 编码的中文链接（如 #%E4%B8%AD%E6%96%87 显示为 ⚓ #中文）
  • 显示链接类型图标：🔗 外部链接、⚓ 内部锚点、✉️ 邮件链接
  • 裸链接（显示文字即 URL）不显示状态栏，避免冗余

Fixed

• Help 菜单修复: 修复 Help 菜单显示 "Help isn't available for FluxMarkdown" 的问题
  • 添加自定义 Help 菜单，替换默认的 macOS Help 菜单
  • FluxMarkdown Help (Cmd+?) 打开在线帮助文档
  • 添加 README、Report an Issue、Release Notes 快捷链接

v1.16.231

Fixed

• 搜索框自动大写修复: 禁用 macOS 在搜索框中自动将句首字母大写的行为
  • 添加 autocapitalize="off" 属性禁用自动大写
  • 添加 autocorrect="off" 属性禁用自动纠正
  • 添加 autocomplete="off" 属性禁用自动完成
  • 添加 spellcheck="false" 属性禁用拼写检查

完整更新日志: v1.16.226...v1.16.231

v1.16.226

Added

• DMG 安装界面设计: 全新的 DMG 安装界面，提供专业的用户体验
  • 现代化明亮风格背景设计，包含中文安装指引（「拖拽到 Applications 安装」）
  • Retina/HiDPI 支持：使用多分辨率 TIFF 背景图，确保在 Retina 显示屏上文字清晰锐利
  • 新增 assets/dmg/ 目录存放 DMG 相关资源

Changed

• DMG 构建工具迁移: 从已废弃的 appdmg 迁移到 create-dmg
  • 更可靠的背景图片渲染
  • 原生支持 macOS Finder 布局特性

Fixed

• DMG 背景图片显示: 修复背景图片不显示、只显示在左上角、不铺满窗口等问题
• DMG Retina 支持: 修复 Retina 显示屏上背景文字模糊的问题
• DMG 窗口滚动条: 修复 DMG 窗口出现横向和纵向滚动条的问题
• Applications 文件夹图标: 修复 Applications 快捷方式显示为空白方框的问题

v1.16.204

What's New

Added

• PDF 导出分页功能: 导出 PDF 时自动将长文档分页为标准 A4 页面
  • 使用 CoreGraphics 将单页 PDF 切片为多个 A4 页面
  • 添加 @media print CSS 规则优化打印样式（防止代码块、图片跨页截断）
  • 最后一页内容自动对齐到页面顶部
• 欢迎窗口 (Welcome Window): 直接启动 App 时显示友好的欢迎界面，引导用户快速上手
  • 大号 "+" 按钮支持点击打开文件或拖拽文件到窗口
  • 简洁的使用提示：QuickLook 空格预览、双击打开、拖拽文件
  • 快捷入口：Open Settings (Cmd+,)、Troubleshooting 帮助文档
  • 显示应用图标，提升品牌识别度
• 用户友好帮助文档: 新增 docs/user/HELP.md，由浅入深引导用户
  • 先体验成功（Space 预览）
  • 常见问题由简到难排查
  • 文末引导到高级排障文档

Fixed

• HTML 导出功能重构: 参考 MPE (Markdown Preview Enhanced) 方案，彻底重构 HTML 导出逻辑
  • 生成纯净的独立 HTML 文件，不再包含臃肿的 JS Bundle（文件体积大幅缩小）
  • 内联所有 CSS 样式，确保离线打开时格式、字体、代码高亮正确显示
  • 自动将本地图片（GIF、PNG、JPG、SVG、WebP）转换为 base64 Data URI，确保图片在任意环境下正常显示
  • 导出的 HTML 可直接分享给他人，无需依赖原始文件路径
• 构建过程警告修复: 清理 make install 过程中的冗余警告信息
  • 抑制 xcodebuild 的 DVTDeviceOperation 内部警告（Xcode 15/16 已知问题）
  • 抑制 Vite 打包的 chunk size 警告（本地应用无需严格限制块大小）
  • 静默 Vite 详细构建日志，提升输出可读性
• 安装脚本兼容性修复: 修复 macOS 新版本上默认应用设置失败的问题
  • 将废弃的 Python LaunchServices 脚本替换为 Swift 原生实现
  • 修复 macOS 12+ 不再自带 LaunchServices Python 模块的问题
• 应用图标透明通道修复: 修复 macOS 12.7 和 15.7 上应用图标显示白色方形背景的问题
  • 使用 AI 图像分割 (rembg) 精准移除白色背景，保留图标内部的白色纸张区域
  • 强制对齐图标边缘为数学直线，消除 AI 抠图产生的波浪边缘
  • 完美保留下拉阴影的半透明渐变效果

Changed

• Troubleshooting 文档优化: 在 docs/user/TROUBLESHOOTING.md 顶部添加提示，引导普通用户先看 HELP.md

---

Download: DMG (9.5M)
SHA256: dd320b21678ac9f34454aa97fd322476f6410e6c4fc10c004b7e714479a1143d