Releases: stanuch/NotionTeX
Release list
v3.0.1 - Stability Patch
This patch release addresses several edge-case bugs encountered during the mass conversion of massive documents (1000+ equations), significantly improving the stability and accuracy of the extension's DOM parser.
Bug Fixes
- Text Node Fragmentation Fix: Solved a critical issue where equations containing unknown words (e.g., specific LaTeX macros like \varphi or \tilde) were being split into multiple DOM text nodes by the browser's native spellchecker. The extension now intelligently reads and maps the entire block's text as a whole, completely eliminating the "missing dollar sign" parsing bug.
- Double Counting Resolution: Fixed an issue where the "Equations Left" HUD counter was decreasing by 2 instead of 1. The script now strictly ignores wrapper contenteditable elements and only processes leaf blocks, ensuring accurate counting and eliminating duplicate DOM processing.
- Arrow-Key Navigation Crash: Fixed an Uncaught TypeError (reading 'text') that occurred when manually skipping an equation using the ArrowRight key.
Improvements
Auto-Retry Mechanism for Heavy Loads: Added a fail-safe for mass conversions. If Notion's React editor momentarily drops a synthetic input event due to heavy background load, the script will now gracefully wait 300ms and retry the conversion once before halting the Auto Mode. This boosts the mass-conversion success rate from ~99.8% to 99.99%.
Important Notice on Notion's Markdown Parser
When pasting raw LaTeX notes into Notion, Notion's aggressive markdown parser may automatically pair underscores (__) and convert them into italics, effectively deleting the underscores from the text before the extension can read them (e.g.,
Recommendation: To preserve your LaTeX subscripts, always paste your raw text into Notion using Paste as Plain Text (Ctrl+Shift+V / Cmd+Shift+V).
v3.0.0 - Performance & Stability Update
This major release completely overhauls the core conversion engine of NotionTeX, trading rigid sleep timers for a smart, dynamic polling architecture. The extension is now significantly faster and incredibly stable, completely eliminating the need for manual speed adjustments.
Major Features & Architectural Changes
- Dynamic DOM Synchronization: Replaced all hardcoded
sleepdelays with a dynamicwaitForConditionloop. The script now actively monitors Notion's React DOM state. It runs as fast as your computer allows, but patiently waits if Notion experiences a lag spike. - Speed Settings Removed: Because the extension now dynamically adjusts to your computer's and network's speed on the fly, the manual "Speed Settings" HUD (
Skey) has been removed. It just works.
Bug Fixes
- Auto Mode Race Conditions: Fixed a critical
menu_timeoutbug where asynchronousEscapekeypresses leaked between equations during rapid Auto mode conversions, causing the slash menu to abruptly close and leave empty equation blocks behind. - Inline Block Splitting: Fixed an issue where equations located mid-paragraph (
span.open > 0) failed to trigger Notion's slash menu. The script now automatically and safely splits the block to ensure the slash menu triggers with 100% reliability. - Background Script Error: Caught a promise rejection in
background.jsthat threw aCould not establish connectionerror when the extension was triggered outside of a loaded Notion tab. - UI Updates: Updated the HUD and
README.mdto reflect the new streamlined shortcut keys and the removal of the speed settings panel.
v2.0.1 - Bug Fix
Bug Fix
Fixed equation conversion failing when equations are inside parentheses, brackets, or immediately after punctuation [e.g., (
v2.0.0 - Automation Overhaul
v2.0.0
This release introduces a significant architectural rewrite of the extension, focusing on stability, speed, and user control. The update addresses previous race conditions in Notion's DOM and introduces a new hybrid workflow for converting LaTeX syntax.
Key Changes
1. Automated Macro Engine
A new Auto Mode (toggled via A key) utilizes keyboard macros to handle conversion without user intervention.
- Smart Detection: Automatically distinguishes between Inline (
$) and Block ($$) syntax. - Command Injection: Uses
/inlinemathand/mathcommands respectively to ensure correct formatting.
2. Performance Tuning
- Adjustable Delays: Users can now configure macro execution speed directly via the HUD overlay. This allows for optimization based on system performance and network latency.
- Reliability: Improved DOM observation logic to prevent skipping items or getting stuck on active dialogs.
v1.0.0 - Initial Stable Release
v1.0.0
- Smart Detection: Automatically finds and highlights LaTeX math (
$...$) in Notion pages. - Navigation HUD: Interactive floating UI showing progress.
- Keyboard Control:
Ctrl+Shift+E: Convert selected text into a native Notion inline equationRight Arrow: Skip current equation (adds to Ignore List for this session).Esc: Exit the tool.
- Skip Logic: Skips allow you to ignore specific text blocks. The tool restores the
$delimiters automatically to keep your notes clean.