TeXcore for Obsidian

A minimalistic Obsidian.md plugin for automatic equation numbering and referencing.

📚 Full Documentation

Key Differences from Original

This fork has been redesigned with a focus on simplicity and performance:

• Single-note focus — Only parses the current active note, no vault-wide scans
• Equation-only — No theorem/proof support, just equation referencing
• Custom ID system — Uses % id: eq-xxx LaTeX comments instead of Obsidian's block references
• Zero dependencies — Quick Preview and Math Links functionality built-in
• Offline TikZ Diagrams — Decoupled, lazy-loaded LaTeX/TikZ rendering via background Web Workers with zero network dependencies

Features

🔢 Automatic Equation Numbering

Add a unique ID to any display math block:

$$
E = mc^2
% id: eq-einstein
$$

Reference it with [[#^eq-einstein]] and the equation is automatically numbered with \tag{1}.

Numbering styles: arabic (1, 2, 3), alph (a, b, c), Alph (A, B, C), roman (i, ii, iii), Roman (I, II, III)

🔗 Smart Referencing

• Type \eqref to trigger autocomplete with all equations in the note
• Fuzzy or simple search to find equations quickly
• Rendered math preview in suggestions
• Hover over links to see equation popups

🎨 TikZ Diagrams

Render TikZ code blocks (```tikz) fully offline and on-demand:

• Fully Offline — Requires no active internet connection. All TeX format files and packages are cached locally in the plugin directory.
• Lazy Loading — Core assets (tex.wasm and core.dump) are cached in memory on first compile. Supplementary packages (like tikz-cd, circuitikz, or pgfplots) are read and decompressed from disk only when requested.
• Background Compiler — Compiles TeX within a Web Worker to ensure Obsidian's interface remains smooth and responsive.

Assets are derived from Glenn Rice's (drgrice1) and Jim Fowler's (kisonecat) TikZJax compiler project, packaged offline by artisticat1.

📄 PDF Export

Full-featured PDF export with:

• Live preview modal
• Page size, margins, orientation settings
• Custom headers and footers
• CSS snippet support
• Batch folder export
• Table of contents generation

✂️ LaTeX Snippets

Create reusable LaTeX code snippets:

• Accessible via command palette
• Each snippet becomes its own command
• Assign hotkeys to frequently used snippets

📦 Callout Support

Math blocks work inside Obsidian callouts with automatic indentation handling:

> [!theorem]
> $$
> x^2 + y^2 = z^2
> % id: eq-pythagoras
> $$

Use the "Fix callout equations" command to repair broken indentation.

Installation

From Community Plugins

1. Open Obsidian Settings → Community plugins
2. Click Browse and search for "TeXcore"
3. Click Install, then Enable

Manual Installation

1. Download main.js, manifest.json, and styles.css from the latest release
2. Create folder: <vault>/.obsidian/plugins/TeXcore/
3. Copy the files into this folder
4. Restart Obsidian and enable the plugin

Quick Start

1. Write a display math block with $$...$$
2. Add % id: eq-yourname on a new line before the closing $$
3. Type \eqref anywhere to search and insert a reference
4. The equation is numbered and the link displays as (1)

Commands

Command	Description
Insert display math	Insert $$...$$ block template
Search equations in active note	Open equation search modal
Fix callout equations in active note	Repair callout indentation
Export current file to PDF	Open PDF export dialog
Insert LaTeX Snippet	Insert a saved snippet

Configuration

See the Settings Reference for all configuration options.

License

MIT License - see LICENSE for details.