LaTeX Color Sync

中文说明

What This Plugin Does

LaTeX Color Sync keeps formula color aligned with nearby text color in Obsidian source mode.

It rewrites formulas to this format:

\\textcolor{#RRGGBB}{...}

Typical use case: when your heading/link/quote text has theme color, your math formula can follow the same color automatically.

Two Ways It Works

1) Auto Sync While Typing

• When your edit inserts a newline (\\n), the plugin auto-syncs nearby formula colors.
• You can disable this in settings if you prefer fully manual control or work with very large notes.

2) Manual Commands

You can also trigger sync from the command palette for partial or full-document updates.

Commands

Recommended Workflow

1. Start with Sync LaTeX Color In Selection Or Current Line.
2. If result is good, run Sync LaTeX Color In Current Document.
3. If needed, press Ctrl/Cmd+Z to rollback immediately.

Settings

Why Sometimes "No Changes"

If command says no changes, common reasons are:

• No valid $...$ or $$...$$ span in target lines.
• Formula color already matches target color.
• Formula is in excluded region (code block, inline code, frontmatter, HTML-like block).
• Formula contains embedded color commands and skip setting is enabled.

Compatibility

• Obsidian >= 1.5.0
• Desktop and mobile (isDesktopOnly: false)
• Source mode editor (CodeMirror 6)

Known Limits

• Formula delimiters must open and close on the same line.
• Extremely custom macros or unusual delimiter styles may need manual edits.

Development And Packaging

You can keep source code split in src/, but release output must be a single root main.js.

1. Install tooling:

npm install

2. Build a production bundle:

npm run build

3. For local development watch mode:

npm run dev

Build result:

• Input: src/main.js (+ imported modules in src/)
• Output: main.js at repo root (single bundled file for Obsidian release)

GitHub Actions Release Flow

This repository includes .github/workflows/release.yml:

• Trigger: push a tag like v0.3.2 (or 0.3.2)
• Action: install dependencies, build main.js, upload release assets
• Uploaded files: main.js, manifest.json, styles.css

Important: the tag version must match manifest.json version exactly.

Privacy

This plugin does not send note content to external services and does not collect telemetry.

Project Files

• Changelog: CHANGELOG.md
• Contributing: CONTRIBUTING.md
• Issue templates: .github/ISSUE_TEMPLATE/

License

MIT. See LICENSE.