# 简墨

**Repository Path**: jide-shan/jian-mo

## Basic Information

- **Project Name**: 简墨
- **Description**: 一款本地优先的极简在线 Markdown 编辑器，支持 GFM / KaTeX / Mermaid，提供实时预览与滚动同步、拖拽导入、多格式导出（HTML/PDF/DOCX/PNG/TXT）、目录与历史版本对比，并支持 PWA 离线使用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简墨（JianMo）

本地优先的极简在线 Markdown 编辑器：支持 **GFM / KaTeX / Mermaid**，提供实时预览与滚动同步、拖拽导入、多格式导出（HTML/PDF/DOCX/PNG/TXT）、目录与历史版本对比，并支持 PWA 离线使用。

## 功能

- Markdown：标准 Markdown + GFM（表格、任务列表、删除线等）
- 扩展：脚注、定义列表、KaTeX 数学公式、Mermaid（```mermaid）
- 体验：实时预览 + 滚动同步（比例映射，避免渲染导致回顶/抖动）
- 导入：文件选择、拖拽导入、粘贴 HTML→Markdown
- 导出：HTML / PDF / DOCX / PNG / 纯文本；复制 Markdown/HTML；分享链接 + 二维码
- 目录：根据标题自动生成（h1~h6）
- 历史：保存版本、差异对比、恢复/删除
- 主题：深色/浅色
- PWA：可离线使用（安装到桌面/主屏）
- 新手工具栏：像 Word 一样点击插入常用 Markdown 语法（工具栏内 ↑ 可收起；右上角 `Aa` 可显示/隐藏）

## 更新提示（看不到最新效果？）

这是 PWA/浏览器缓存导致的常见现象：

- 先尝试强制刷新：`Ctrl/Cmd+Shift+R`
- 或用无痕窗口打开再验证
- 若已“安装到桌面/主屏”，请关闭应用重开，必要时清理该站点数据后再试

## 快捷键

- `Ctrl/Cmd+O`：打开文件
- `Ctrl/Cmd+S`：下载 `.md`
- `Ctrl/Cmd+E`：导出面板
- `Ctrl/Cmd+K`：目录 / 历史
- `Ctrl/Cmd+Shift+L`：切换主题
- `?`：帮助

## 开发

需要 Node.js 18+。

```bash
npm install
npm run dev
```

## 构建

```bash
npm run build
```

产物位于 `dist/`。

## 部署（静态站点）

- Nginx：将 `dist/` 作为站点根目录，并配置 SPA fallback（`try_files ... /index.html`）
- 或直接部署到 Vercel / Netlify / GitHub Pages（注意路由回退）

## 许可

MIT（见 `LICENSE`）。