# typora_plugin **Repository Path**: jscloud/typora_plugin ## Basic Information - **Project Name**: typora_plugin - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-10-21 - **Last Updated**: 2025-10-21 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README 简体中文 | [English](https://github.com/obgnail/typora_plugin/blob/master/README-en.md)

Typora Plugin

typora_plugin

Ask DeepWiki

| # | 插件 | 功能 | 默认启用 | | ---- | ----------------------- | ------------------------------------ | -------- | | 1 | window_tab | 标签页管理 | | | 2 | search_multi | 多元文件搜索 | | | 3 | collapse_paragraph | 章节折叠 | × | | 4 | collapse_list | 列表折叠 | × | | 5 | collapse_table | 表格折叠 | × | | 6 | md_padding | 中英文混排优化 | | | 7 | slash_commands | 斜杠命令 | | | 8 | templater | 文件模板 | | | 9 | resource_manager | 一键清除无用图片 | | | 10 | fence_enhance | 复制、折叠、格式化代码 | | | 11 | toc | 在右侧生成大纲目录 | | | 12 | commander | 命令行环境 | | | 13 | toolbar | 多功能搜索 | | | 14 | right_click_menu | 右键菜单统一管理插件 | | | 15 | pie_menu | 圆盘菜单 | × | | 16 | datatables | 表格增强（搜索、过滤、分页、排序等） | × | | 17 | preferences | 插件配置 | | | 18 | markmap | 提供 markmap 组件支持 | | | 19 | echarts | 提供 echarts 组件支持 | | | 20 | chart | 提供 chartjs 组件支持 | | | 21 | drawIO | 提供 drawIO 组件支持 | | | 22 | abc | 提供 abcjs 组件支持 | | | 23 | calendar | 提供 tui.calendar 组件支持 | | | 24 | wavedrom | 提供 wavedrom 组件支持 | | | 25 | marp | 提供 marp 组件支持 | | | 26 | callouts | 提供 callouts 支持 | | | 27 | text_stylize | 文字风格化 | | | 28 | read_only | 只读模式 | | | 29 | blur | 模糊模式 | | | 30 | kanban | 看板 | | | 31 | timeline | 时间线 | | | 32 | chat | 聊天 | | | 33 | file_counter | 显示目录下的文件数 | | | 34 | auto_number | 章节、表格、图片、代码块等自动编号 | | | 35 | imageReviewer | 图片查看器 | | | 36 | chineseSymbolAutoPairer | 中文符号自动补全 | | | 37 | resize_table | 调整表格行高列宽 | | | 38 | resize_image | 调整图片显示大小 | | | 39 | export_enhance | 导出 HTML 时避免图片丢失 | | | 40 | markdownLint | markdown 格式检查 | | | 41 | go_top | 一键到文章顶部、底部 | | | 42 | truncate_text | 暂时隐藏内容，提高大文件渲染性能 | × | | 43 | dark | 夜间模式 | | | 44 | no_image | 无图模式 | | | 45 | updater | 一键升级插件 | | | 46 | easy_modify | 编辑工具 | | | 47 | editor_width_slider | 写作区宽度调整 | | | 48 | redirectLocalRootUrl | 重定向本地资源根目录 | × | | 49 | blockSideBySide | 并列显示活动块 | × | | 50 | scrollBookmarker | 书签管理器 | × | | 51 | cipher | 加密文件 | × | | 52 | ripgrep | 使用 ripgrep 搜索文件 | × | | 53 | article_uploader | 一键上传博客到支持的所有平台 | × | | 54 | sortableOutline | 拖动大纲标题，调整文章结构 | × | | 55 | cursor_history | 光标跳转 | × | | 56 | static_markers | Markdown 标记常显 | × | | 57 | custom | 开放平台，用户自定义插件（高级） | | | 58 | hotkeys | 快捷键注册中心（高级） | | | 59 | quickButton | 于右下角添加功能按钮（高级） | | | 60 | json_rpc | 外部操纵 Typora（高级） | × | > 如果有需求或发现 BUG，欢迎 [提 issue](https://github.com/obgnail/typora_plugin/issues/new)，欢迎 PR。如果觉得本项目对您有帮助，请不吝点亮一个 Star ⭐！ ## Q&A - **我的 Typora 能用吗？** 要求 Typora 版本大于等于 0.9.98（最后一个免费版本）。 - **如何修改插件配置？** 通过右键菜单 -> 少用插件 -> 插件配置。**尊重用户的一切选择**，所有的插件和功能皆可永久启用 / 禁用。 - **如何升级插件？** 通过右键菜单 -> 少用插件 -> 插件配置 -> 升级插件。 - **如何卸载插件？** 通过右键菜单 -> 少用插件 -> 插件配置 -> 卸载插件。 - **如何编写插件？** 本项目坚持 **No BuildTime**，因此无需安装任何开发环境，详情请参考 [Readme](https://github.com/obgnail/typora_plugin/blob/master/plugin/custom/README.md)。 - **支持 Typora for Mac 吗？** 我没有 Mac 设备，故暂不支持。 - **还有其他问题？** 欢迎前往 [AI Wiki](https://deepwiki.com/obgnail/typora_plugin) 提问或查阅社区讨论。 ## 如何使用：Windows/Linux 平台 前往 [视频安装教程](https://github.com/obgnail/typora_plugin/issues/847) 1. [下载](https://github.com/obgnail/typora_plugin/releases/latest) 插件源码的压缩包，并解压 2. 进入 Typora 安装路径，找到包含 `window.html` 的文件夹 A - 正式版 Typora 对应的路径为 `./resources/window.html` - 免费版 Typora 对应的路径为 `./resources/app/window.html` 3. 将解压得到的 plugin 文件夹粘贴进文件夹 A 下 4. 进入文件夹 `A/plugin/bin/` - Windows 系统：右键 `install_windows.ps1` 文件，点击 `使用 PowerShell 运行` - Linux 系统：以管理员运行 `install_linux.sh` 5. 验证：重启 Typora，在正文区域点击鼠标右键，弹出右键菜单栏，如果能看到 `常用插件` 栏目，说明一切顺利 | | 正式版 | 免费版 | | -------- | -------------------------------------------- | -------------------------------------------- | | 步骤 2-3 | ![typora_dir_new](assets/typora_dir_new.png) | ![typora_dir_old](assets/typora_dir_old.png) | | | Windows | Linux | | ------ | ---------------------------------------------- | ------------------------------------------ | | 步骤 4 | ![install_windows](assets/install_windows.png) | ![install_linux](assets/install_linux.png) | ## 如何使用：archlinux 平台 > 目前此方法仅限 archlinux 平台，aur 见 [aur/typora-plugin](https://aur.archlinux.org/packages/typora-plugin) ```sh yay -S typora-plugin ``` ## 插件使用说明 所有的插件都提供了四种使用方法： - 键盘党： - `Ctrl+J` 调出插件列表（详见 `toolbar` 插件） - 快捷键（详见 `hotkeys` 插件） - 鼠标党： - 在正文区域右键调用（详见 `right_click_menu` 插件） - 快捷按钮（详见 `quickButton` 插件） ### window_tab：标签页管理 - `切换标签`：Ctrl+滚轮滚动、ctrl+shift+tab、ctrl+tab、ctrl+PgUp、ctrl+PgDn - `关闭标签`：ctrl+w、鼠标中键 - `新窗口打开`：ctrl+单击标签 - `排序标签`：拖拽 - `弹出标签的菜单选项`：右键单击标签页 ![window_tab](assets/window_tab.gif) ### search_multi：多元文件搜索 功能：搜索通过组合不同的条件来精确查找文件。 使用方式： - 方式一：右键菜单 -> 常用插件 -> 多元文件搜索 - 方式二：快捷键 `ctrl+shift+P` 使用示例：搜索语法类似于 Google 搜索语法，支持正则表达式。 | 输入 | 搜索文件 | | --------------------------------------------------- | ------------------------------------------------------------ | | `pear` | 包含 pear | | `sour pear` | 包含 sour 和 pear | | `sour OR pear` | 包含 sour 或 pear | | `"sour pear"` | 包含 sour pear 词组 | | `sour pear -apple` | 包含 sour 和 pear，且不含 apple | | `/\bsour\b/ pear mtime=2024-03-12` | 匹配正则 \bsour\b，且包含 pear，且文件的修改时间为 2024-03-12 | | `frontmatter:开发 OR head=plugin OR strong:MIT` | YAML Front Matter 包含开发 或者 标题内容为 plugin 或者 加粗文字包含 MIT | | `size>10kb (linenum>=1000 OR hasimage=true)` | 文件大小超过 10KB，并且文件要么至少有 1000 行，要么包含图片 | | `thead:k8s h2:prometheus blockcode:"kubectl apply"` | 表头包含 k8s，且二级标题包含 prometheus，且代码块内容包含 kubectl apply | ![search_mutli](assets/search_mutli.gif) ### collapse_paragraph：章节折叠 功能：折叠 / 展开 章节下所有文本。支持折叠的标签：h1~h6。 - `折叠/展开单个章节`：ctrl+click - `折叠/展开父章节下所有同级的章节`：ctrl+alt+click - `折叠/展开所有同级的章节`：ctrl+shift+alt+click ![collapse_paragraph](assets/collapse_paragraph.gif) ### collapse_list：列表折叠 功能：折叠 / 展开 无序列表、有序列表、任务列表。 ### collapse_table：表格折叠 功能：折叠 / 展开 表格。 ### md_padding：中英文混排优化 功能：中英文混排时，中文与英文之间、中文与数字之间添加空格。 快捷键：ctrl+shift+B ![md_padding](assets/md_padding.gif) ### slash_commands：斜杠命令 功能：类似于 notion 的 slash command。 支持： - 插入文字片段（snippet） - 插入组件 - 编辑样式 - 执行任意逻辑 ![slash_commands](assets/slash_commands.gif) ### templater：文件模板功能 功能：类似于 obsidian 的文件模板功能，根据模板快速创建文件。 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> 文件模板。 ![templater](assets/templater.gif) ### resource_manager：一键清除无用图片 功能：资源管理，清除无用图片 使用方式：右键菜单 -> 少用插件 -> 资源管理 ### fence_enhance：复制，折叠，格式化代码 ![fence_enhance](assets/fence_enhance.png) ### toc：在右侧生成大纲目录 功能：Typora 侧边栏的【文件】和【大纲】不能同时显示，为了解决此问题，此插件会在右侧新增一个【大纲】。 使用方式： - 方式一：常用插件 -> 二级插件 -> 大纲目录 - 方式二：右键点击侧边栏的【大纲】按钮 ### commander：命令行环境 功能：类似于 total commander 的命令行，一个快速执行命令的工具，并提供少量交互。 使用方式：右键菜单 -> 常用插件 -> 命令行环境 支持 shell： - `cmd/bash`：Windows 或 Linux 的默认终端 - `powershell`：微软的傻儿子 :D - `git bash`：需确保安装 Git Bash 并添加到环境变量 - `wsl`：需确保安装 WSL2 并添加到环境变量 内置环境变量： - `$f`：当前文件路径 - `$d`：当前文件的所属目录 - `$m`：当前挂载的根目录 ![commander](assets/commander.gif) ### markmap：提供 markmap 支持 使用方式： - 方式一：右键菜单 -> 少用插件 -> markmap - 方式二：直接点击右下角的 markmap 按钮 ![markmap](assets/markmap.gif) ### toolbar：多功能搜索 功能：类似于 vscode 的 ctrl+shift+p 功能 使用方式： - 方式一：右键菜单 -> 少用插件 -> 多功能搜索 - 方式二：快捷键 `ctrl+j` 支持搜索： - `his`：最新打开过的文件 - `plu`：插件 - `tab`：打开的标签页 - `ops`：常用操作 - `out`：文档大纲 - `mode`：切换文件模式 - `theme`：临时切换主题 - `func`：功能列表 - `all`：混合查找（所有项目都混在一起查找） 键入内容说明： - 键入内容 = 搜索工具名称 + 空格 + 搜索内容 - 支持 `交集查询`、`差集查询`，并且可以随意组合（类似于 google 的正负向查询） 举例： - `his node learn`：查找最近打开的文件，要求文件标题【包含 node 和 learn 两个关键字】 - `plu multi -search`：查找插件，要求插件名【包含 multi 关键字，但是不包含 search 关键字】 - `tab -messing`：查找所有打开的标签页，要求标签页名称【不包含 messing 关键字】 - `his close -win -mark 标签`：查找最近打开的文件，要求文件标题【包含 close、标签，不包含 win、mark】 ![toolbar](assets/toolbar.gif) ### right_click_menu：右键菜单统一管理插件 所有插件都支持在右键菜单中直接调用。鼠标党可以将右键菜单作为所有插件的主要调用方式。 可以通过修改配置自定义右键菜单： ```toml # 每一个MENUS对应一个一级菜单，允许无限添加一级菜单，允许重复添加同一个插件 # NAME: 一级菜单的名称 # LIST: 二级菜单的插件列表（使用"---"代表在页面上插入一个divider，以作分隔） [[right_click_menu.MENUS]] NAME = "少用插件" LIST = [ "window_tab", "fence_enhance", ... ] [[right_click_menu.MENUS]] NAME = "常用插件" LIST = [ "commander", "markmap", ... ] ``` ### pie_menu：圆盘菜单 使用方式： - `弹出圆盘菜单`：Ctrl+鼠标右键 - `旋转圆盘菜单`：鼠标中键 - `固定圆盘菜单，圆盘不再自动消失`：鼠标左键圆心 - `展开圆盘菜单，圆盘不再自动收缩`：鼠标右键圆心 ### preferences：插件配置 使用方式：右键菜单 -> 少用插件 -> 插件配置 ### echarts：提供 echarts 支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Echarts ![echats](assets/echarts.png) ### chart：提供 chartjs 支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Chart ![chart](./assets/chart.png) ### drawIO：提供 drawIO 组件支持 ![drawIO](./assets/drawIO.png) ### abc：提供 abc 组件支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> ABC ![abcjs](./assets/abcjs.png) ### calendar： 提供 tui.calendar 组件支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Calendar ![calendar](./assets/calendar.png) ### wavedrom：提供 wavedrom 组件支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Wavedrom ![wavedrom](./assets/wavedrom.png) ### marp：提供 marp 组件支持 功能：使用 markdown 做 PPT。 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Marp ### callouts： 提供 callouts 支持 使用方式：右键菜单 -> 常用插件 -> 二级插件 -> Callouts ![callouts](./assets/callouts.png) 数量、类型、颜色、icon 皆可自己定义，请前往配置修改。 ### kanban：看板 拓展代码语法，添加看板功能。 ![kanban](assets/kanban.png) ### timeline：时间线 拓展代码语法，添加时间线功能。 ![timeline](./assets/timeline.png) ### chat：聊天 拓展代码语法，添加聊天功能。 ![chat](./assets/chat.png) ### text_stylize：文字风格化 功能：将文字转为 HTML 格式，改变文字样式。 使用方式：右键菜单 -> 少用插件 -> 文字风格化。 ![text_stylize](./assets/text_stylize.gif) ### read_only：只读模式 功能：只读模式下文档不可编辑（开启后，右下角数字统计区域会出现 `ReadOnly` 字样） 快捷键：ctrl+shift+R ### blur：模糊模式 功能：开启后，只有当前聚焦的组件可见，其余模糊。可以用于防偷窥。 使用方式：右键菜单 -> 少用插件 -> 模糊模式 > 此插件只能于正式版 Typora 使用。 ### file_counter：显示文件数 ![file_count](assets/file_counter.png) ### auto_number：自动编号 ![auto_number](assets/auto_number.png) 和其他使用 Theme CSS 的实现方式不同，此插件通过修改内置函数，完美解决导出 PDF 后侧边栏没有编号的问题 :) ### imageReviewer：图片查看器 功能：一站式图片查看，并且提供简单图片编辑。 使用方式： - 方式一：点击右下角【查看图片】按钮 - 方式二：右键菜单 -> 常用插件 -> 二级插件 -> 图片查看器 ![image-reviewer](./assets/image-reviewer.png) ### chineseSymbolAutoPairer：中文符号自动补全 功能：输入 `《 【 （ ‘ “ 「` 符号时自动补全。 ### datatables：表格增强 功能：增强表格。提供搜索、过滤、分页、排序等功能。 使用方式：将光标定位在表格 -> 右键菜单 -> 少用插件 -> 表格增强。 ![datatables](assets/datatables.png) ### resize_table：拖动调整表格大小 功能：`ctrl+鼠标拖动`：修改表格的行高列宽。 ![resize_table](assets/resize_table.gif) ### resize_image：调整图片大小 功能：`alt+鼠标滚轮滚动`：调整图片大小。 ### export_enhance：导出增强 功能：导出 HTML 时，将图片转为 base64，避免图片丢失。 ### go_top： 一键到顶 功能：在右下角添加一个一键到顶的按钮。 ### dark：夜间模式 使用方式：右键菜单 -> 常用插件 -> 夜间模式 ### no_image：无图模式 使用方式：右键菜单 -> 常用插件 -> 无图模式 ### markdownLint：markdown 格式检查 功能：检测当前文件是否符合 markdown 最佳实践规范。 使用方式： 1. 方法一：点击右上角的小方块 2. 方法二：右键菜单 -> 常用插件 -> 二级插件 -> 格式检查 ### updater：一键升级插件 使用方式：右键菜单 -> 少用插件 -> 升级插件 > 众所周知，有些用户并不能裸连 github 下载最新插件，故提供了设置代理功能（默认为系统代理） ### easy_modify：编辑工具 使用方式：右键菜单 -> 常用插件 -> 编辑工具 本插件是常用的编辑工具集合，目前包括： 1. 复制标题路径 2. 提升选中文段的标题等级 3. 降低选中文段的标题等级 4. 换行符 CRLF 转为 LF 5. 换行符 LF 转为 CRLF 6. 移除不可见字符 7. 根据文档大纲一键生成思维导图：mindmap 8. 根据文档大纲一键生成思维导图：graph 9. 提取选区文字到新文件 10. 添加结尾空格 ### editor_width_slider：写作区宽度调整 使用方式：右键菜单 -> 少用插件 -> 写作区宽度调整 功能：调整写作区的宽度 ### redirectLocalRootUrl：重定向本地资源根目录 功能：如果你主要使用 obsidian 或 joplin 来管理文件，偶尔用 typora 打开文件。就会遇到一个问题：obsidian 或 joplin 都是将本地资源放在同一个目录中，这导致在 typora 打开后文件由于路径错误，无法访问本地资源。此插件就是为了解决此问题，重定向本地资源根目录。 > 此插件默认关闭，需手动开启。 ### blockSideBySide：并列显示活动块 功能：活动块默认是上下显示，改为并列显示。 ![blockSideBySide](./assets/blockSideBySide.png) > 注意：通过注入 CSS 实现此功能，有可能会与你使用的 theme 冲突。 ### scrollBookmarker： 书签管理器 使用方式： 1. 使用 alt+click 正文内容，打上书签。 2. 此时会自动调出书签管理器，点击上面的书签，即可跳转到书签。 显示/隐藏书签管理器：右键菜单 -> 常用插件 -> 二级插件 -> 书签管理器 ### cipher：加密文件 使用方式：右键菜单 -> 少用插件 -> 加密文件。 ### truncate_text：暂时隐藏内容，提高大文件渲染性能 功能：大文件在 Typora 的渲染性能很糟糕，用此插件暂时隐藏内容（只是隐藏显示，不修改文件），提高渲染性能。也可以用于防偷窥。 使用方式：右键菜单 -> 少用插件 -> 文本截断。 包含的功能如下： - 隐藏最前面：隐藏最前面的文本段，只留下最后 80 段。 - 重新显示：重新显示之前隐藏的所有文本段。 - 根据当前可视范围显示：根据当前可视范围显示文本段。 > 原理：通过设置 DOM 元素的 display 样式为 none 来隐藏元素，让元素不占用渲染树中的位置，对隐藏的元素操作不会引发其他元素的重排。 ### ripgrep：使用 ripgrep 搜索文件 Typora 自带 ripgrep。此插件支持使用内建的 ripgrep 进行文件搜索。 > 使用此插件需要您熟悉 ripgrep 工具。此插件默认关闭，需手动开启。 ### sortableOutline：拖动大纲标题，调整文章结构 > 此插件默认关闭，需手动开启。 ### cursor_history：光标跳转 - 上一个光标历史的快捷键：alt+← - 下一个光标历史的快捷键：alt+→ > 此插件默认关闭，需手动开启。 ### static_markers：Markdown 标记常显 告别格式刷新的干扰，让您的 Markdown 语法标记 **始终可见、保持静态**。 禁用所见即所得模式下的语法标记自动隐藏功能，让 **、##、_ 等所有 Markdown 标记像在源码模式中一样，永远清晰地展示在您的文本周围。 > 此插件默认关闭，需手动开启。 ### hotkeys：快捷键注册中心（高级） > 此插件是高级插件，仅对有 JavaScript 基础的用户开放。 功能：以声明的形式，为【任意插件系统函数】或【任意自定义函数】绑定快捷键。 ### quickButton：于右下角添加功能按钮（高级） > 此插件是高级插件，仅对有 JavaScript 基础的用户开放。 功能和 hotkeys 类似，以声明的形式，为【任意插件系统函数】设置快捷按钮。 ### custom：开放平台，用户自定义插件（高级） > 此插件是高级插件，仅对有 JavaScript 基础的用户开放。 功能：提供开放能力，支持用户自己写插件。 具体使用请参考 [README.md](https://github.com/obgnail/typora_plugin/blob/master/plugin/custom/README.md)。 ### json_rpc：外部操纵 Typora（高级） 功能：将包括 typora-plugin 所有功能在内的一切能力通过 `json-rpc` 的形式暴露出去，以供外部操纵 Typora。 具体使用请参考 [README.md](https://github.com/obgnail/typora_plugin/blob/master/plugin/json_rpc/README.md)。 > 此插件是高级插件，仅对开发人员开放。开启此插件后，外部将拥有 node、browser 两套环境，能完全控制电脑，因此如果您不是开发人员，请勿开启此插件。 > ### article_uploader：上传博客文章 功能：用户点击或者使用快捷键触发当前文章的自动发布功能，程序根据用户配置自动发布博客文章到各大平台 具体使用参考： [README.md](https://github.com/obgnail/typora_plugin/blob/master/plugin/article_uploader/README.md)。以上传到 CSDN 为例，Gif 图如下： ![CSDN 成功演示](https://my-picture-bed1-1321100201.cos.ap-beijing.myqcloud.com/mypictures/CSDN%E6%88%90%E5%8A%9F%E6%BC%94%E7%A4%BA.gif) ## 致谢 - Apache：[ECharts](https://echarts.apache.org/zh/index.html) | [draw.io](https://github.com/jgraph/drawio) - MIT：[markmap](https://markmap.js.org/) | [Chart.js](https://www.chartjs.org/) | [abcjs](https://github.com/paulrosen/abcjs) | [tui.calendar](https://github.com/nhn/tui.calendar) | [Marp](https://marp.app/) | [WaveDrom](https://wavedrom.com/) | [DataTables](https://github.com/DataTables/DataTables) | [markdownlint](https://github.com/DavidAnson/markdownlint) - no-licence：[typora-tabbar-plugin](https://github.com/gatziourasd/typora-tabbar-plugin) | [typora-side-by-side](https://github.com/gruvw/typora-side-by-side) | [md-padding](https://github.com/harttle/md-padding) ## 结语 **本项目遵循 MIT 协议，请自由地享受。** 如果对各位有用的话，欢迎 star ⭐，欢迎推荐给你志同道合的朋友使用。