新增 site/ 静态落地页(单文件 HTML,无构建步骤): - Hero + 应用外观示意(纯 CSS 模拟,不带截图文件) - 功能卡片(实时预览 / 多标签多窗口 / 文件目录 / 大纲 / 查找高亮 / 复制文件 / 拖放 / 主题 / 渲染) - 快捷键表(两列) - 下载区:/download/XiaoyinMarkdown-win32-x64.zip,并给出 Gitea / GitHub 源码入口 - 深色浅色跟随系统、响应式 部署与访问(家宽 → EdgeOne): 1Panel 静态站(8443 + acme.sh 泛域名证书) → EdgeOne 加速域名 md.wangjinding.com(回源 wangjinding.dynv6.net:8443) → 边缘免费证书 → 阿里云 DNS CNAME → md.wangjinding.com.eo.dnse2.com README 补一行官网入口。
7.0 KiB
7.0 KiB
小银 Markdown
一个纯本地的 Windows Markdown 编辑器。左边写、右边看,不联外网、不登录、不收集任何东西。
官网 / 下载:https://md.wangjinding.com
装在哪(示例)
- 程序:
%USERPROFILE%\Apps\XiaoyinMarkdown\XiaoyinMarkdown.exe - 桌面快捷方式:
小银Markdown(双击即可)
功能
- 两种打开方式:「标签」模式=一个窗口内多标签切换;「独立窗口」模式=每个文档一个窗口。点工具栏「标签 / 窗口」按钮即可切换,偏好会记住,重启后仍然生效
- 切换时自动迁移:从独立窗口切到标签 → 所有窗口里的文档合并进一个窗口的多个标签;从标签切到独立窗口 → 每个标签拆成一个独立窗口。未保存的正文、滚动位置、光标位置都会跟着过去,不会丢失
- 右键打开:文件树中右键「在新标签打开」或「在新窗口打开」——具体行为按当前记住的模式走;菜单「文件 → 在新窗口打开」快捷键
Ctrl+Shift+N - 左侧文件目录:列出当前文件夹里的 Markdown / 文本文件;单击只选中,双击才打开(文件夹也是双击展开),跟资源管理器的习惯一致;当前打开的文件高亮,会记住上次打开的文件夹
- 文件条目操作:文件树里右键「复制文件」=调用 Windows 原生复制(
Ctrl+C),剪贴板里是文件本身,到资源管理器或微信等地方Ctrl+V能粘贴出文件副本;另有「复制文件内容」(正文文本)、「复制文件名」「复制完整路径」「在资源管理器中显示」 - 实现说明:Electron 45 的 clipboard API 没有写文件的能力,所以通过
koffi直接调用 Win32SetClipboardData(CF_HDROP),效果等同于在资源管理器里选中文件按Ctrl+C - 右侧章节大纲:按
#标题自动生成章节树,点一条跳到对应位置;随编辑实时更新,滚动时自动高亮当前章节 - 两个开关标识:「目录」紧挨在「编辑 / 分栏 / 阅读」切换按钮之前,「大纲」在它的右侧;样式统一,亮=展开、灭=收起,关掉随时能再打开,状态会记住
- 面板宽度可拖拽:目录右缘、大纲左缘各有一条分隔条,拖动即可调整宽度(有最小宽度限制);宽度自动记住,重启后保持
- 查找:
Ctrl+F查找条,Enter/Shift+Enter上下切换;右侧预览正文里所有命中都会加黄色背景标记,当前命中橙色并自动滚到可视区,编辑内容变化时标记实时恢复,关闭查找自动清除 - 实时预览:编辑 / 分栏 / 阅读三种模式,分栏宽度可拖动
- 拖进来就打开:把
.md文件拖进窗口直接打开;把文件夹拖进来,左侧列出该目录 - 右键菜单:复制全文、打开当前文件所在文件夹、剪切 / 复制 / 粘贴 / 全选 / 撤销 / 重做
- 文件操作:新建、打开、保存、另存为、打开文件夹,关窗时会提示未保存
- 查找:带匹配计数和上下跳转
- 深色 / 浅色主题,字号缩放
- 渲染支持:标题、粗体斜体删除线、行内代码、代码块、引用、有序无序与嵌套列表、任务列表、表格(含对齐)、分割线、链接、图片
- 状态栏显示字数、字符数、光标行列;保留原文件的换行符(CRLF / LF)
- 渲染前会转义 HTML,预览里的链接用系统默认浏览器打开
快捷键
| 操作 | 快捷键 |
|---|---|
| 新建 / 打开 | Ctrl+N / Ctrl+O |
| 保存 / 另存为 | Ctrl+S / Ctrl+Shift+S |
| 撤销 / 重做 | Ctrl+Z / Ctrl+Y |
| 剪切 / 复制 / 粘贴 / 全选 | Ctrl+X / C / V / A |
| 查找 | Ctrl+F |
| 复制全文 | Ctrl+Shift+C |
| 打开文件夹 | Ctrl+Shift+K |
| 在新窗口打开当前文档 | Ctrl+Shift+N |
| 显示 / 隐藏文件目录 | Ctrl+Shift+B |
| 显示 / 隐藏章节大纲 | Ctrl+Shift+T |
| 复制文件树中选中项(文件本身) | Ctrl+C(焦点在条目上) |
| 在资源管理器中显示当前文件 | Ctrl+Shift+O |
| 编辑 / 分栏 / 阅读 | Ctrl+1 / Ctrl+2 / Ctrl+3 |
| 深色浅色切换 | Ctrl+Shift+L |
| 放大 / 缩小 / 还原 | Ctrl+Shift+= / Ctrl+Shift+- / Ctrl+0 |
| 全屏 / 开发者工具 | F11 / F12 |
编辑区里还有两个顺手的细节:Tab 插入缩进;在列表项末尾按回车会自动续上下一条标记。
自己改代码
源码在本目录。目录结构:
md-editor/
├─ src/
│ ├─ main.js 主进程:窗口、菜单快捷键、文件读写、对话框
│ ├─ preload.js 安全桥接(contextIsolation 开启)
│ └─ renderer/
│ ├─ index.html 界面结构
│ ├─ style.css 样式与两套主题
│ ├─ markdown.js 自写的 Markdown 渲染引擎(零依赖)
│ └─ app.js 交互逻辑
├─ tools/ 自测与打包辅助脚本(不参与发布)
└─ build/icon.ico 应用图标
开发调试:
npm start
跑一遍功能自测(31 项,覆盖渲染用例、打开保存、撤销粘贴、查找、模式切换、文件树展开与打开):
npx electron tools/test.js
单独验证真实拖放链路(用 CDP 注入系统级拖放事件,确认能取到路径并打开文件/文件夹):
npx electron tools/dragtest.js
验证侧栏启动行为与记忆恢复(记住文件夹、收起状态持久化):
npx electron tools/sidetest.js
验证章节目录(生成、开关、跳转定位、实时更新、状态记忆):
npx electron tools/outlinetest.js
验证文件树复制(右键复制文件名/路径/内容、Ctrl+C、按钮位置):
npx electron tools/copytest.js
验证标签页、独立窗口偏好、右键打开方式(21 项):
npx electron tools/multitest.js
验证真实主进程能否创建多个独立窗口:
node tools/wintest.js
验证模式切换时的双向迁移(多窗口合并成标签、标签拆成多窗口,11 项):
npx electron tools/migrationtest.js
验证关闭窗口时主进程不抛异常:
npx electron tools/closetest.js
验证目录/大纲宽度拖拽与记忆(14 项):
npx electron tools/paneltest.js
重新打包 exe:
npx electron-packager . XiaoyinMarkdown --platform=win32 --arch=x64 --out=dist ^
--overwrite --asar --icon=build/icon.ico --ignore="^/dist" --ignore="^/tools" --ignore="^/build"
打包完成后把 dist\XiaoyinMarkdown-win32-x64 整个目录拷到 %USERPROFILE%\Apps\XiaoyinMarkdown 覆盖即可(exe 依赖同目录的 dll,不能只拷 exe)。
说明
- 未做代码签名,首次运行 Windows SmartScreen 可能提示"未知发布者",选"仍要运行"即可。
- 程序只读写你主动打开或保存的文件,不联网(预览里的链接除外,会交给系统浏览器)。