Visual Math Editor

by Oliver
5
4
3
2
1
Score: 30/100

Description

Visual Math for Obsidian: write math, chemistry and physics notes with no LaTeX knowledge required. Visual/LaTeX/Hybrid editing, equation graphs, units and custom formula shortcuts. Offline; English, Chinese and Spanish.

Reviews

No reviews yet.

Stats

3
stars
431
downloads
0
forks
32
days
9
days
9
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
2
total issues
2
open issues
0
closed issues
24
commits

Latest Version

9 days ago

Changelog

1.1.0 — 2026-11-10 · Desktop release

What's New in 1.1.0

  • Multi-line equations in one box (↵ New line / Shift+Enter): You can now add line breaks directly inside the visual equation box without leaving the current formula. Multi-line equations use \displaylines{...} (and preserve existing aligned / gathered / cases environments) so step-by-step derivations stay in a single block.
  • Cleaner layout & compact secondary bar: Secondary math tools (Trig & geometry, Sets & sequences, Matrix, System, Advanced math, Import) now sit in a single-row pill bar that opens one drawer at a time instead of stacking multiple open panels.
  • Live preview as you type: The Matrix builder (1×1–6×6), Equation System builder (2–6 rows), and Single-Formula Import panel now update their math preview automatically while you type, without requiring a separate Preview click first.
  • Simpler trilingual copy & updated screenshots: Trimmed repetitive helper text across English, Simplified Chinese, and Spanish. Updated the documentation with fresh 1.1.0 screenshots, the official website (oranipost.github.io/visual-math), and the official YouTube channel (@VisualMathForObsidian).
  • Code & CSS cleanup: Resolved the 15 non-blocking TypeScript and CSS lint warnings from the 1.0.0 community directory scan.
  • Checks: Passed 274 automated tests (npm run check) and 1,250 real-browser component checks across six suites. Desktop only, minimum Obsidian 1.14.4 (en, zh-CN, es). Existing settings (data.json), Markdown equations, and vme-plot graph/geometry blocks remain compatible. See TEST-REPORT.md for coverage and platform boundaries.
  • Install or update in Obsidian: Open Settings → Community plugins → Check for updates (or search Visual Math in Obsidian Community Plugins). Save any open equation draft before updating, then restart Obsidian to refresh MathLive.
  • Manual ZIP installation: Download visual-math-editor-1.1.0.zip below and extract main.js, manifest.json, and styles.css into <your-vault>/.obsidian/plugins/visual-math-editor/ (keep your existing data.json). visual-math-editor-source-1.1.0.zip provides the complete GPLv3 + Obsidian linking exception Corresponding Source and pinned dependency archives; verify archive hashes with SHA256SUMS.txt.
  • Resources: Official Website · YouTube Tutorials (@VisualMathForObsidian) · Installation & Updating Guide · Test Report

1.1.0 更新说明(桌面正式版)

1.1.0 新功能与改进

  • 同一公式框内直接多行输入(↵ 换行 / Shift+Enter):现在可以直接在主可视化公式框内点击 ↵ 换行 或按 Shift+Enter 另起一行继续推导,无需切出当前公式或打开独立子面板。底层采用 \displaylines{...}(同时完整保留已有的 aligned / gathered / cases 多行环境),让多步演算自然保持在同一个公式块内。
  • 更清爽的紧凑二级胶囊栏:三角与几何、集合与数列、矩阵、方程组、高等数学、导入单条公式 整合为单排紧凑按钮栏,每次只展开当前所需抽屉,不再层层堆叠面板。
  • 输入即实时预览:矩阵编辑器(1×1–6×6)、方程组编辑器(2–6 行)与单公式导入面板现支持随输入自动刷新数学预览,无需先手动点击一次“预览”。
  • 中英西三语文案精简与全新截图:精简了中、英、西三语界面中的重复说明文字;更新了 1.1.0 实机演示截图,并补充了官方网站(oranipost.github.io/visual-math)与官方 YouTube 教学频道(@VisualMathForObsidian)入口。
  • 代码与样式维护清理:全部清理了 1.0.0 社区插件目录自动扫描指出的 15 条非阻塞 TypeScript 与 CSS 提示。

验证说明、链接与安装方式

  • 验证范围:通过 274 项自动化测试与六套共 1,250 项真实浏览器组件检查。仅限桌面端(最低 Obsidian 1.14.4,支持简体中文、English、Español)。完整保留既有用户配置(data.json)、普通 Markdown 公式与 vme-plot 图像/几何块兼容性。详细边界见 TEST-REPORT.md。
  • 在 Obsidian 内安装或更新:前往 设置 → 第三方插件 → 检查更新(或在 Obsidian 社区插件市场 搜索 Visual Math)。更新前请先保存正在编辑的公式草稿,更新后重启 Obsidian 窗口以刷新 MathLive。
  • 手动 ZIP 安装:下载下方附件中的 visual-math-editor-1.1.0.zip,将解压出的 main.js、manifest.json、styles.css 放入 <你的仓库>/.obsidian/plugins/visual-math-editor/ 目录(升级时请保留原有的 data.json)。visual-math-editor-source-1.1.0.zip 包含完整 GPLv3(含 Obsidian 链接例外)对应源码与锁定依赖包,可通过 SHA256SUMS.txt 校验哈希值。
  • 相关链接:官方网站 · YouTube 教学频道 (@VisualMathForObsidian) · 安装与更新说明 · 测试报告

README file from

Github

Visual Math for Obsidian

English · 简体中文 · Español

Install in Obsidian · Official Website · YouTube Tutorials · Download 1.1.0 ZIP · Release Notes

Overview

I built Visual Math so you can write math, chemistry, and physics notes in Obsidian without typing raw LaTeX by hand every time.

When you open the editor inside a note, you can click fractions, roots, integrals, sums, matrices, or equation systems and fill in the boxes directly. If you already know LaTeX, switch to LaTeX or Hybrid mode to edit the code and the rendered formula side by side. Press ↵ New line (Shift+Enter) whenever you want multiple lines inside the same equation block.

Everything saves as standard $…$ or $$…$$ Markdown in your note, and all fonts, unit tables, and graphing tools run locally offline.

Visual Math 1.1.0 in Obsidian


What's Inside

  • Visual, LaTeX, and Hybrid editing: Edit with visual placeholders, raw TeX source, or both at once. Includes multi-line equations (↵ New line), undo/redo history, and single-formula LaTeX import.
  • Matrices, systems, sets, and calculus notation: Build 1×1 to 6×6 matrices, 2–6 row equation systems with a left brace, 19 set/sequence symbols, trig/geometry notation, and 9 calculus/vector templates.
  • Function, polar, 3D surface, and complex graphs: Plot y = f(x) (with numerical 1st/2nd derivatives and definite integrals), polar curves r = f(θ), 3D surfaces z = f(x, y), and Re / Im complex points right below your equation.
  • 3D geometry models: Rotate and zoom 7 geometric solids (sphere, cylinder, cone, pyramid, prism, cuboid, plane) and 3 spatial intersection scenes (two planes, line–plane, sphere–plane).
  • Chemistry, physics, units, and periodic table: Write chemical reactions (\ce) with balance checks, insert physics formulas, convert across 63 units in 11 categories (\pu), and look up all 118 elements.
  • Offline and trilingual: Works without internet or external accounts. Available in English, 简体中文, and Español.

Quick Start

  1. Open the editor: Place your cursor in a note and click ∑ in the note header or left ribbon (or run Visual Math: Insert or edit equation from the command palette).
  2. Fill in a structure: In Visual mode, click fraction, type 3, press Tab, and type 4. Use the secondary tool bar (Trig & geometry, Sets & sequences, Matrix, System, Advanced math, Import) whenever you need larger structures.
  3. Save or plot: Pick Inline equation ($…$) or Display equation ($$…$$) at the bottom right of the card and click Insert equation (Ctrl/Cmd + Enter), or click Graph this equation to plot the formula right below the editor.

Installation

From Obsidian Community Plugins

  1. Open Visual Math in the Obsidian Plugin Directory and click Add to Obsidian.
  2. Click Install, then Enable inside Obsidian.
  3. Open any Markdown note and click ∑.

Manual ZIP Installation (1.1.0 Desktop Release)

Download visual-math-editor-1.1.0.zip (compiled release archive; do not download GitHub's Source code archive):

  1. Extract the visual-math-editor folder into <your-vault>/.obsidian/plugins/.
  2. Check that main.js, manifest.json, styles.css, and the license files sit directly inside .obsidian/plugins/visual-math-editor/.
  3. Restart Obsidian and enable Visual Math under Settings → Community plugins.

See the Installation & Updating Guide for full instructions.


Screenshots (v1.1.0)

Hybrid Mode, Multi-Line Equations & Compact Tool Bar

Hybrid mode and multi-line editing in Visual Math 1.1.0

Visual Matrices & Equation Systems

Visual matrix and equation system builders with live preview

2D Function Calculus & 3D XYZ Surfaces

Function graph with definite integral shading and 3D surface plot

3D Geometry Solids & Spatial Scenes

3D geometry model and spatial intersection scene

Chemistry Balance, Unit Converter & Periodic Table

Chemistry reaction balance, offline unit conversion, and periodic table


Scope & Limits

  • Notation and bounded plotting: Visual Math formats mathematical and scientific notation and renders numerical graphs and teaching geometry scenes. It does not symbolically solve equations, evaluate matrix operations, sort sets, or prove theorems.
  • Single-formula import: Accepts bare LaTeX or one matching outer delimiter pair ($…$, $$…$$, \(...\), \[...\]) up to 8,192 characters. Formulas up to 4,096 characters render a live visual preview; valid formulas between 4,097 and 8,192 characters keep their exact source for editing in LaTeX or Hybrid mode without truncation.
  • Matrices and equation systems: 1–6 rows/columns for matrices and 2–6 single-column rows for equation systems (cases). Empty matrix cells can be filled with 0 explicitly; resizing keeps hidden cells during the current session.
  • Graphs and geometry:
    • Explicit functions y = f(x) (up to 500 characters), polar curves r = f(θ) (θ span up to 100π), numerical 1st/2nd derivatives and definite integrals on finite continuous intervals, 3D wireframe surfaces z = f(x, y), and up to 20 rectangular complex points (a + bi, up to 1,000 characters).
    • Saved equation blocks ($…$ / $$…$$) and graph blocks (vme-plot) are separate blocks in the note after saving; use Edit graph or Save view on a graph block to update its stored view.
  • Science tools: Chemistry (\ce{…}) and units (\pu{…}) require host mhchem support when exported outside Obsidian. Offline unit conversion covers 63 preset units across 11 categories using pinned Convert 8.0.2 constants. Element details follow CIAAW and NIST reference data.
  • Compatibility: Requires Obsidian 1.14.4+ on desktop. Verification records are maintained in TEST-REPORT.md and CHANGELOG.md.

Build From Source

Requires Node.js 22 or 24:

npm ci
npm run check
npm run package

Local component preview for development (binds to 127.0.0.1:8471 only):

npm run preview

See CONTRIBUTING.md, RELEASING.md, LANGUAGE-SUPPORT.md, and third-party-sources/README.md.


Privacy, Support & License

  • Offline & private: No telemetry, no remote fonts or CDNs, and no background clipboard monitoring. Clipboard access is used only when you explicitly copy, cut, or paste inside the editor. See SECURITY.md.
  • Author & contact: Built by Oliver / oranipost ([email protected]). Report bugs or suggestions on GitHub Issues.
  • License: Starting with 0.7.0, project code is licensed under GNU GPL v3.0 only with the Obsidian linking exception (Copyright © 2026 Dongfang Wang; earlier ≤ 0.6.5 code retains its historical MIT grant). Bundled MathLive, Convert, KaTeX fonts (MIT), and mhchem (Apache 2.0) notices are in THIRD-PARTY-NOTICES.md. Your own notes and formulas are never covered by GPL.