PRACTICE / 03
mTypora Markdown 阅读器
实践项目 · Windows 桌面 Markdown 编辑器
Windows 优先的桌面 Markdown 编辑器:以 CodeMirror 单文档面承载,源码始终权威、渲染就地发生——标题 / 强调 / 链接 / 表格 / 代码块 / KaTeX / Mermaid / 安全 HTML 即写即现。Tauri + SvelteKit 实现,纸感玻璃(浅色)与澄层(深色)双主题。
面向 Windows 的桌面 Markdown 编辑器,核心思路是单一 CodeMirror 文档面:不拆「编辑 / 预览」双栏,Markdown 源码始终权威,标题、行内强调、链接、表格、代码块、KaTeX 公式、Mermaid 图与经消毒的原始 HTML 都就地渲染在源码位置,写作流不被打断。
外观与主题
浅色「纸感玻璃」:淡雅半透明 chrome + 不透明阅读画布;深色「澄层」:克制的类亚克力 chrome + 不透明暗色画布。仅非核心 chrome 允许透出桌面壁纸,文档画布保持高可读性;窗口透明可关,减少透明度 / 强制色彩 / 原生背景初始化失败均回退为纯色且布局尺寸不变。
文档层细节
桌面文档层字节保真:混合 LF/CRLF 行尾、UTF-8 BOM、UTF-16 文档原样保留;外部文件变更在文档干净时自动重载、有本地编辑时报告冲突;超过 5 MiB 的大文件自动进入轻量可写模式(搜索 / 撤销 / 保存 / 源码编辑仍可用),完整渲染可显式重试。
安全边界
非空 CSP、作用域资源协议、最小权限 Tauri 能力;Markdown HTML 消毒、Mermaid 严格模式、外链仅限 http/https/mailto、文档与图片路径按会话授权。
验证体系
Vitest 单测 + Playwright E2E(含 1 MB 大文档性能门禁)+ Rust 文档层测试 + fast-check 属性测试,配套 Windows 11 人工核对清单(IME / 远程桌面 / 故障注入等需真机会话的项单列)。
SCREENSHOTS
TECH STACK