README file from
GithubObsidian Easy LaTeX
An Obsidian plugin that provides intelligent LaTeX auto-completion in math contexts, with multilingual keyword support (Chinese, Japanese, Korean, English) and AI-powered formula generation.
Features
LaTeX Command Completion
Type \ inside math contexts ($...$, $$...$$, or LaTeX code blocks) to get a searchable suggestion list of 200+ LaTeX commands. Filter by prefix or description.
Multilingual Keyword Completion
Type math terms in your language directly in math contexts — no backslash needed. The plugin matches them to relevant LaTeX commands.
- Chinese:
积分→\int,矩阵→\begin,约等于→\approx(prefix matching supported) - Japanese:
せきぶん→\int,ぎょうれつ→\begin,ぶんすう→\frac - Korean:
적분→\int,행렬→\begin,분수→\frac - English: type
\keywordin math mode (e.g.,\frac→\frac{}{})
Custom Keyword Mappings
Define your own keyword-to-LaTeX mappings in Settings → Easy LaTeX → Custom Keyword Mappings.
- Latin keywords: type
\keywordin math mode to trigger. E.g., mapdiv→\frac{$1}{$2}, then typing\divsuggests\frac{}{}with cursor positioned inside the first{}. - CJK keywords (Chinese/Japanese/Korean): type the keyword directly. E.g., map
分数→\frac{$1}{$2}, then typing分数replaces it with\frac{}{}. - Snippets support
$1,$2tabstop placeholders for cursor positioning.
Example: Map div → \frac{$1}{$2}. Now typing \div in a math zone shows your custom \frac{}{} suggestion alongside the built-in \div (÷).
| Field | Description | Example |
|---|---|---|
| Keyword | The trigger text | div, 分数, ぶんすう, 분수, bracket |
| LaTeX Snippet | The LaTeX to insert (include \ prefix) |
\frac{$1}{$2}, \left($1\right) |
AI Formula Generation
Press Tab on selected text inside a math zone, and the AI will convert your natural language description into LaTeX code. Works with any OpenAI-compatible API.
Installation
Obsidian Community Plugin Store
- Open Obsidian Settings → Community Plugins
- Click Browse and search for "Easy LaTeX"
- Click Install, then Enable
Manual
- Download
main.js,styles.css, andmanifest.jsonfrom the latest release - Create a folder
easy-latexinside your vault's.obsidian/plugins/directory - Copy the three files into that folder
- Enable the plugin in Obsidian Settings → Community Plugins
AI Configuration
Go to Settings → Easy LaTeX to configure:
| Setting | Description | Default |
|---|---|---|
| API URL | OpenAI-compatible API endpoint | https://api.openai.com/v1/chat/completions |
| API Key | Your API key | — |
| Model | Model name (e.g., gpt-4o-mini, deepseek-chat) |
gpt-4o-mini |
| System Prompt | System prompt sent to the AI | Built-in LaTeX converter prompt |
The AI feature is optional — the completion list works without any API configuration.