Yank Note

一款面向程序员的 Markdown 笔记应用

[toc]{level: [2]}

特色

• 使用方便：使用 Monaco 编辑器（vscode 编辑器内核）编辑，针对 Markdown 文件添加了快捷键和补全规则
• 兼容性强：资源保存本地，Markdown 文件可简单处理离线工作；拓展功能尽量用 Markdown 原有的语法实现
• 高拓展性：可在文档中嵌入小工具、可运行的代码块、ECharts 图形、Plantuml 图形、Drawio 图形等
• 支持加密：用来保存账号等隐私文件，文件可单独设置密码

注意事项

• Yank Note 是一款针对程序员的 Markdown 编辑器，目标应用场景为在本机写文章、日志、笔记，编写小工具。
• 为了更高的拓展性和方便性，Yank Note 牺牲了安全防护（命令执行，任意文件读写）。如果要用它打开外来 Markdown 文件，请务必仔细甄别文件内容是值得信任的。
• 如果要改造为对外的 Web 服务，请运行在隔离可控的环境下，注意应用安全。
• 加密文件的加密解密操作均在前端完成，请务必保管好自己的密码。一旦密码丢失，就只能暴力破解了。

Yank-Note 2.0 开发计划

V2 项目看板

• 项目更名为 Yank-Note
• 前端界面可以拖动调整尺寸
• 重构前端项目结构，便于拓展：引入 vuex，使用 async await 代替可怕的回调，规范文件接口
• 暴露 Api 接口可以在文档中嵌入轻量应用，以便构建一些小工具
• 使用 Electron 构建为桌面应用。不追求完全做成客户端，还是可以沿用 CS 架构。同样可以在浏览器中使用
• 支持嵌入 draw.io 文档
• 文件目录增加右键菜单
• 支持多标签打开多个文件
• 拥有更友好的配置界面
• 可以自定义快捷键

特色功能

• 同步滚动：编辑区和预览区同步滚动，预览区可独立滚动
• 目录大纲：预览区目录大纲快速跳转
• 文件加密：以 .c.md 结尾的文件视为加密文件
• 自动保存：文件编辑后自动保存，未保存文件橙色标题栏提醒（加密文档不自动保存）
• 编辑优化：列表自动补全
• 粘贴图片：Ctrl + V 粘贴剪切板里面的图片，使用快捷键 Ctrl + B + V 作为 Base64 形式粘贴
• 嵌入附件：可以添加附件到文档，点击在系统中打开
• 代码运行：支持运行 PHP，nodejs，Python，bash 代码，示例见 FEATURE.md
• 待办列表：支持显示文档中的待办进度，点击可快速切换待办状态
• 快速打开：可使用快捷键 Ctrl + P 打开文件切换面板，以便快捷打开文件，标记的文件，全文搜索文件内容
• 内置终端：支持在编辑器打开终端，快速切换当前工作目录
• 公式解析：支持输入 katex 公式代码
• 样式风格：Markdown 使用 GitHub 风格样式和特性
• 数据仓库：可定义多个数据位置以便文档分类
• 外链转换：将外链或 BASE64 图片转换为本地图片：Ctrl + Shift + 单击图片 Ctrl + Alt + L 转换所有外链图片到本地
• HTML 解析：可以直接在文档里面使用 HTML 代码，也可以使用快捷键 Ctrl + M + V 粘贴复制 HTML 为 Markdown
• docx 导出：后端使用 pandoc 做转换器
• TOC 支持：生成 TOC 在需要生成目录的地方写入 [toc]{type: "ol", level: [1,2,3]} 即可，，示例见 FEATURE.md
• 编辑表格单元格：Ctrl + 单击单元格 快捷编辑表格单元格
• 复制标题链接：Ctrl + 单击标题 复制标题链接路径到剪切板，便于插入到其他文件
• 嵌入小工具：文档支持内嵌 HTML 小工具，示例见 FEATURE.md
• 嵌入 Plantuml 图形：需要安装 Java，graphviz ，示例见 FEATURE.md
• 嵌入 drawio 图形：文档支持内嵌 drawio 图形，示例见 FEATURE.md
• 嵌入 ECharts 图形：在文档中嵌入 Echarts 图形，示例见 FEATURE.md
• 嵌入 Mermaid 图形：在文档中嵌入 Mermaid 图形，示例见 FEATURE.md
• 嵌套列表转脑图展示：可将嵌套列表用脑图的方式展示，示例见 FEATURE.md
• 元素属性书写：可自定义元素的任意属性，示例见 FEATURE.md
• 表格解析增强：表格支持表格标题多行文本，列表等特性，示例见 FEATURE.md
• 文档交叉链接跳转：支持在文档中引入其他文档，互相跳转
• 脚注功能：支持在文档中书写脚注

上手使用

• 在 最新版本 下载对应平台应用即可
• 默认快捷键参考 vscode
  • Ctrl + X 剪切所选/当前行
  • Ctrl + C 复制所选/当前行
  • Ctrl + Z 撤消
  • Ctrl + Shift + Z 反撤消
  • Ctrl + / 注释行
  • Ctrl + Shift + A 注释段
  • Ctrl + K, Ctrl + X 删除尾部空格
  • Alt + Click 插入光标
  • Shift + Alt + ↑/↓ 在相邻行插入光标
  • Ctrl + U 取消最后添加的光标
  • Shift + Alt + I 在选中区的所有行的最后添加光标
  • Ctrl + D 为下一个匹配项添加光标
  • Ctrl + F 查找
  • Ctrl + H 替换
• 自定义编辑器快捷键
  • Ctrl + P 打开文件快速跳转面板
  • Ctrl + S 保存文档
  • Ctrl + Enter 强制插入新行，忽略预置补全规则
  • Shift + Enter 强制插入 Tab，忽略预置补全规则
  • Ctrl + Shift + Up 当前行上移
  • Ctrl + Shift + Down 当前行下移
  • Ctrl + Shift + D 重复当前行
  • Ctrl + Alt + D 插入当前日期
  • Ctrl + Alt + T 插入当前时间
  • Ctrl + Alt + F 插入文件附件
  • Ctrl + Alt + I 插入文档链接
  • Ctrl + J 连接行 join lines
  • Ctrl + K, Ctrl + U 转换大写
  • Ctrl + K, Ctrl + L 转换小写
  • Ctrl + Alt + R 在内置终端里面运行选中内容
  • Ctrl + M + V 粘贴 html 富文本
  • Ctrl + B + V 粘贴图片为 Base64
  • Ctrl + Alt + Left/Right 切换编辑器 Tab

开发

依赖安装和编译比较麻烦，请保证自己有足够耐心且有科学上网的手段。

Windows

Windows 上安装 node-pty 需要费一番功夫，请参考 https://github.com/microsoft/node-pty#windows 配置编译环境。

REM Node 版本要求 12 v12.7.0
node -v

REM 前端
cd frontend
REM 安装依赖
yarn
REM 打包
yarn run dist
REM 开发
yarn run serve

REM Electron 端
cd ../
REM 安装依赖
win-install.bat
REM 打包 打包前请在前端目录运行打包命令
win-build.bat
REM 开发
yarn run start

Liunx

TODO 手头没有环境，待完善

OSX

TODO 手头没有环境，待完善

界面截图

更新日志

最新发布

v2.4.10 2020-12-16

1. 优化脑图使用体验

展开查看更多版本记录

v2.4.9 2020-12-15

1. 增加大纲列表脑图展示功能

v2.4.7 2020-12-02

1. 修复编辑表格跨列单元格问题

v2.4.6 2020-11-26

1. 增加编辑单元格内容功能

v2.4.5 2020-11-26

1. 移除代码表格的悬停样式

v2.4.4 2020-11-25

1. 更改 TOC 标号样式

v2.4.3 2020-11-25

1. 表格新增悬停样式：行号，突出当前行

v2.4.2 2020-11-20

1. 新增同步渲染按钮
2. 调整打印样式

v2.4.1 2020-10-27

1. 在 Electron 环境中开启缩放页面功能

v2.4.0 2020-10-26

1. Vue 框架升级到 3.0
2. 升级 Electron 版本
3. 升级前端依赖，更好的支持 Mermaid 图形

v2.3.8 2020-09-01

1. 增加开机自动启动功能

v2.3.7 2020-08-03

1. 优化预览鼠标事件响应

v2.3.6 2020-06-30

1. 升级 Electron 到 9.0.5

v2.3.5 2020-06-29

1. 增加脚注功能

v2.3.4 2020-06-28

1. 优化图片相对链接解析
2. 优化转换外链图片为本地图片功能

v2.3.3 2020-06-11

1. 修正标题过长导致大纲目录样式异常

v2.3.2 2020-04-27

1. 调整启动命令行参数

v2.3.1 2020-04-27

1. 增加配置监听端口命令行参数 --port=8080

v2.3.0 2020-04-27

1. 增加启动命令行参数

v2.2.11 2020-04-20

1. Drawio 文件渲染增加翻页按钮

v2.2.10 2020-04-07

1. 新增粘贴图片为 Base64 形式快捷键 Ctrl + B + V
2. 更改粘贴富文本为 Markdown 快捷键为 Ctrl + M + V

v2.2.9 2020-03-17

1. 修复公式解析问题

v2.2.8 2020-03-13

1. 增加切换编辑器标签快捷键 Ctrl + Alt + Left/Right

v2.2.7 2020-01-19

1. 调整渲染的表格宽度

v2.2.6 2020-01-16

1. 修复插入文档名称问题

v2.2.5 2020-01-14

1. 修复 frontend yarn.lock 问题

v2.2.4 2020-01-14

1. 修复 frontend yarn.lock 问题

v2.2.3 2020-01-13

1. 增加复制行内代码功能

v2.2.2 2019-12-27

1. 修复快速打开面板小问题

v2.2.1 2019-12-26

1. 修复跳转中文路径处理
2. 优化插入文档文件链接

v2.2.0 2019-12-25

1. 增加文档之间跳转功能
2. 增加复制文档标题链接功能
3. 调整文档插入选择面板
4. 修复高分辨率下目录树箭头消失问题

v2.1.1 2019-12-24

1. 增加在当前目录创建文件菜单
2. 限制快捷跳转列表数量以提高性能
3. 标题栏最大化窗口后移除尺寸调节

v2.1.0 2019-11-29

1. 增加多标签同时打开多个文件

v2.0.2 2019-11-21

1. 修复相对链接解析
2. 图片增加背景色便于透明图片的阅读

v2.0.1 2019-11-20

1. 增加 2.0 计划
2. Electron 打包
3. 增加 HTML 小工具渲染
4. 增加特色功能说明和示例
5. 目录树自动定位文件
6. 目录树增加右键菜单
7. 目录树和集成终端增加拖动调整尺寸功能
8. 使用自定义 UI 控件代替浏览器阻塞性弹出框，优化界面样式，提升交互体验
9. 默认仓库数据和配置改为在 <home>/yank-note 下保存
10. 重构前端代码便于拓展
11. 前端重构文件接口

v1.23.0 2019-07-09

1. 增加转换所有外链图片到本地功能 Ctrl + Alt + L

v1.22.0 2019-05-20

1. 增加粘贴 html 富文本功能 Ctrl + B + V
2. 增加插入文档快捷键 Ctrl + Alt + I
3. 修复 vue cli 3 打包错误
4. 修复图片链接转义
5. 搜索排除 node_modules
6. 上传文件目录优化

v1.21.0 2019-05-03

1. 调整抓取图片到本地的逻辑
2. 优化目录树样式
3. 目录树排除 node_modules
4. eslint 规则调整

v1.20.0 2019-04-18

1. 无功能变化，前端使用 vue cli 3

v1.19.0 2019-04-15

1. 增加终端打开目录功能 Ctrl + Alt + 单击目录
2. 增加刷新目录树功能 Ctrl + Alt + 单击目录

v1.18.2 2019-03-21

1. 保存加密文件密码不一致时增加提示
2. 修复样式问题

v1.18.1 2019-03-01

1. 修复目录样式
2. 修复代码块样式

v1.18.0 2019-02-28

1. 代码块增加行号显示
2. 支持统一文档锚点跳转
3. 移除 Mermaid 支持
4. 优化打印样式
5. 优化行内代码样式

v1.17.0 2019-02-20

1. 支持 ECharts 图形
2. Ctrl + Alt + R 在内置终端中运行选中代码

v1.16.2 2019-02-18

1. 文件树增加操作说明
2. 新增/重命名文件后打开新文件

v1.16.1 2019-02-17

1. 修复打印样式

v1.16.0 2019-02-16

1. 增加 Readme 展示
2. 处理终端退出逻辑

v1.15.1 2019-02-14

1. 更新 UI
2. 内置终端增加 windows 适配

v1.15.0 2019-02-13

1. 增加内置终端
2. 运行代码支持在内置终端运行

v1.14.0 2019-01-16

1. 上传附件增加日期
2. 快速跳转改用模糊搜索并高亮匹配项

v1.13.1 2019-01-14

1. 修复 hr 标签样式

v1.13.0 2019-01-05

1. 增加 toc
2. 增加返回顶部按钮

v1.12.0 2019-01-03

1. 增加连接行快捷键 Ctrl + J
2. 增加转换大小写快捷键 Ctrl + K, Ctrl + U Ctrl + K, Ctrl + L

v1.11.0 2019-01-02

1. 切换编辑器自动换行：Alt + W 或点击状态栏 切换换行 按钮

v1.10.0 2018-12-24

1. 文件列表自然排序
2. 文件目录增加子项目数量显示

v1.9.0 2018-11-12

1. 增加切换文档预览功能

v1.8.0 2018-08-29

1. 增加在系统中打开文件/目录功能 Ctrl + 双击文件/目录

v1.6 2018-08-22

1. 修复部分样式不和谐
2. 修复打开新文件编辑器滚动位置不正确
3. 增加将外链或 BASE64 图片转换为本地图片功能
4. 优化代码高亮在暗色主题下的展示
5. 渲染链接默认在新标签打开

v1.5.2 2018-08-13

1. 优化输入数字列表体验
2. 增加直接插入回车和Tab的快捷键
3. 确保文件最后有空行
4. 文件跳转按照最近打开文件排序

v1.5.1 2018-08-06

1. 修复打开上一次文件bug

v1.5 2018-08-06

1. 增加状态栏
2. 添加多仓库支持

v1.4 2018-08-02

1. 增加全文搜索功能
2. 修复公式定位问题

v1.3 2018-08-02

1. 增加待办记录时间
2. 增加 bat 脚本运行
3. 优化使用体验

v1.2 2018-07-30

1. 增加待办进度条展示

v1.1 2018-07-29

1. 修复若干问题
2. 增加附件插入
3. 调整为暗色主题
4. 图片新标签预览
5. 增加文件筛选面板 Ctrl + p