一个面向知识工作者的 Markdown 阅读与 Word 导出工具。
稳定预览包含 HTML 表格的 Markdown 文档，并支持 Word 纸张预览与导出。
杨卫薪律师 - 专注于技术类纠纷领域（知识产权、数据与 AI），同时热衷于将 AI 技术应用于法律实务。
Folia 是我在法律文档处理和 AI 协作实践中沉淀出来的轻量桌面工具。
- GitHub: cat-xierluo
- 个人主页：cat-xierluo.github.io/personal-site
- 微信：
ywxlaw
Folia 是拉丁语 folium（叶子）的复数形式，借取了「一片叶子 = 一页文档」的意象——做一款轻量、随手展开的 Markdown 阅读器时，这个名字既直观又克制。
另一层隐喻来自同名音乐术语 folia：巴洛克时期古老的 d 小调变格进行，后世作曲家不断在它之上即兴变奏、衍生出不同形态（Folia 主题与变奏）。Folia 的产品形态也类似——同一份 Markdown 源文档，在主编辑器、HTML 预览、Word 纸张预览、.docx 导出等不同 surface 之间反复呈现，每一种形态都从同一份内容「变奏」而来。
普通用户建议直接从 GitHub Releases 下载最新版本。
- macOS Apple Silicon：下载带
aarch64/arm64字样的.dmg - macOS Intel：下载带
x64/x86_64字样的.dmg - Windows：下载
.exe或.msi安装包
安装后 Folia 会默认检查更新，也可以在“设置 / 关于”中手动检查或关闭自动检查。
当前版本尚未做 Apple Developer 公证。如果 macOS 提示“无法验证开发者”或“已损坏”，请先把 Folia.app 拖到“应用程序”，然后在终端执行一次：
xattr -dr com.apple.quarantine /Applications/Folia.app
open /Applications/Folia.app如果你把应用放在其他位置，请把命令里的 /Applications/Folia.app 换成实际路径。这个命令只应对你信任来源的应用执行。
- 打开
.md/.markdown/.html文件（对话框或拖拽） - 普通 Markdown 默认所见即所得编辑，保留源码模式 fallback
- 原生 HTML 表格文档自动进入稳定阅读预览，完整渲染合并单元格等复杂结构，并可一键进入源码编辑
- HTML 文件可手动进入演示模式，在隔离视图中运行演示脚本并支持常见翻页操作
- 按需打开 Word 多页纸张预览，支持预设选择、自定义 JSON 预设导入和
.docx导出 - 按需打开 HTML 预览面板，支持复制到公众号编辑器、内联样式 HTML 导出、内置主题预设和自定义 CSS 槽位
- 浮动文档大纲（TOC），默认弱显示，hover 展开，可固定并点击跳转
- 保存 / 另存为
- 自动检查更新默认开启，也可在设置 / 关于中手动检查或关闭
- 安全处理：Vditor 内置 XSS 过滤（sanitize: true）
- Tauri v2
- React 19 + TypeScript
- Vite 8
- Vditor.preview()（Lute 引擎 + 代码高亮 / Mermaid / KaTeX）
- CodeMirror 6
本地开发需要先安装：
- Node.js 与 npm
- Rust stable toolchain
- macOS 构建还需要 Xcode 或 Xcode Command Line Tools
Tauri CLI 已作为项目开发依赖安装，不需要额外全局安装。更完整的系统依赖可参考 Tauri 官方前置条件。
启动桌面开发模式：
npm install
npm run tauri dev只调试前端页面时，也可以运行：
npm run dev常用验证命令：
npm test
npm run lint
npm run typecheck只验证前端构建：
npm run build本地打包桌面应用：
npm run tauri:build:local构建产物通常位于 src-tauri/target/release/bundle/。
欢迎通过 Issue / Pull Request 参与 Folia。贡献流程与规范见 CONTRIBUTING.md。
Apache License 2.0