Obsidian-LaTeX-input

LaTeX Input

LaTeX 公式输入面板 — 妈妈再也不用担心我遇到不认识的希腊字母了~

一个为 Obsidian 设计的 LaTeX 公式输入插件。点选符号面板自动生成源码、实时预览、插入到当前笔记;支持屏幕选区截图识别剪贴板图片识别,公式录入快人一步。


:sparkles: 特性

  • :bullseye: 点选符号 — 10 个分类、~250 条符号,点击即插入到光标位置

  • :eyes: 实时预览 — 所见即所得,所写即所得

  • :keyboard: 可编辑源码 — 源码框支持 LaTeX 微调

  • :camera_with_flash: 截图识别公式Ctrl+Shift+S 拖拽选区,OCR 自动转 LaTeX

  • :clipboard: 剪贴板识别 — 截图后 Ctrl+Shift+R 直接读图

  • :nine_o_clock: 历史记录 — 自动持久化,可载入继续编辑

  • :last_quarter_moon: 暗色适配 — 完美跟随 Obsidian 主题

  • :package: 零外部依赖 — MathLive 已内联进 main.js


:rocket: 快速开始

方式一:从 Release 下载(推荐)

  1. 前往 Releases 下载 main.jsmanifest.jsonstyles.css

  2. 在 vault 下创建路径:.obsidian/plugins/latex-input/

  3. 把上面三个文件放进去

  4. 设置 → 第三方插件 → 已安装插件 → 启用 LaTeX Input

方式二:源码构建

git clone <this-repo>
cd latex-input
npm install
npm run build

构建产物 main.js 在仓库根目录,连同 manifest.json / styles.css 一起部署到 .obsidian/plugins/latex-input/


:keyboard: 快捷键

操作 快捷键
插入行内公式 $...$ Ctrl + Shift + L
插入行间公式 $$...$$ Ctrl + Shift + M
截图识别(选区,行内) Ctrl + Shift + S
截图识别(选区,行间) Alt + Shift + S
剪贴板识别(行内) Ctrl + Shift + R
剪贴板识别(行间) Alt + Shift + R
面板内插入到笔记 Ctrl + Enter
关闭面板 Esc

也可点击左侧栏 σ 图标打开面板。设置 → 快捷键 可重新绑定。


:camera_with_flash: 截图识别

Ctrl+Shift+S(行内)/ Alt+Shift+S(行间):

  1. 屏幕共享可用时 — 弹出全屏遮罩,拖拽框选公式区域 → 释放后自动 OCR 并插入

  2. 屏幕共享不可用时 — 自动切到「剪贴板轮询」模式,右下角小浮窗提示;任意方式截图后自动检测 + 自动识别 + 自动插入

Ctrl+Shift+R / Alt+Shift+R 直接读取剪贴板中的图片。

首次使用需在插件设置里配置 OCR 服务(API 地址、Key、模型名)。


:puzzle_piece: 面板布局


:hammer_and_wrench: 自定义符号

打开 symbols.ts,按格式添加:

{ display: "∑", insert: "\\sum_{i=1}^{n} " }
  • display — 按钮上显示的文字

  • insert — 点击后插入的 LaTeX 源码

  • 需光标定位时,在 insert 里放 {cursor}

npm run build   # 重新编译

:file_folder: 文件结构

latex-input/
├── manifest.json       # Obsidian 插件元数据
├── main.js             # 编译产物(运行时加载)
├── main.ts             # 入口源码
├── symbols.ts          # 符号库(10 分类、~250 条)
├── styles.css          # 样式
├── package.json        # npm 配置
├── esbuild.config.mjs  # 构建脚本(esbuild + MathLive 虚拟模块)
├── tsconfig.json       # TypeScript 配置
└── versions.json       # 版本兼容映射

:page_facing_up: 许可

Copyright © 2026 Sun · Licensed under GPL-3.0

仓库链接: GitHub - Sun8854/Obsidian-LaTeX-input · GitHub

1 个赞