Skip to content

v0.0.1

Choose a tag to compare

@github-actions github-actions released this 05 Jun 12:52

What’s New in v0.0.1

  • Equation Numbering & Smart Referencing

    • Automatic Equation Tagging: Automatically detects and numbers LaTeX display math blocks configured with custom % id: eq-xxx identifier comments.
    • Flexible Numbering Styles: Supports multiple styles including Arabic (1, 2, 3), Alphabetic (a, b, c / A, B, C), and Roman (i, ii, iii / I, II, III) numerals.
    • Auto-completion & Search: Type \eqref to summon fuzzy search suggestions listing equations in the active note.
    • Live Preview & Reading View Renderers: Custom CodeMirror 6 extensions and markdown post-processors display rendered tag indicators ((1)) in both editing and reading views.
    • Page Preview Hovers: Patches Obsidian's native page-preview hover popups to show equation definitions when hovering over reference links.
  • Integrated TikZJax Diagram Renderer

    • Native TikZ Support: Write diagrams directly within ```tikz blocks without needing external compilers.
    • Offline-Capable Cache: Downloads and localizes the hefty offline TikZJax engine on first launch to ensure smooth functionality without constant network calls.
    • Dark Mode Adaptation: Automatically post-processes SVG output and color attributes (e.g. converting black strokes/fills to currentColor) to render cleanly across both light and dark Vault themes.
    • Row-Layout System: Provides structured multi-diagram row displays (+tikz syntax) in editing and reading views.
  • Advanced PDF Export Features

    • Comprehensive Customization: Open a dedicated configuration modal to set page sizes, orientation, margins, custom headers, and footers.
    • Svelte-Based Progress Tracking: Displays a beautiful rendering and compilation progress indicator during exports.
    • Batch Folder Exporting: Recursively traverses folders to export multiple files in one action.
    • Table of Contents (TOC) Generator: Generates a standard markdown _TOC_.md containing links to folder files to simplify larger documentation exports.
  • Workflow & Productivity Enhancements

    • LaTeX Snippets Manager: Define frequently used LaTeX snippets in settings, automatically registering each as an Obsidian command ready for custom hotkey mapping.
    • Custom Note Keybindings: Bind custom shortcuts to open selected .md notes directly in a new tab.
    • Zotero Annotation Cleanup: Scans configured directories for duplicate zotero:// links and automatically purges duplicated annotation blocks to keep the active note neat.
    • Callout Alignment Helper: Includes a fixer command (Fix callout equations in active note) to repair indentation mismatches that often break MathJax rendering inside callout call-outs.
  • Integrated Quick Preview

    • Provides instant, rich previews of equations and link destinations directly within autocomplete list interfaces.

Full Changelog: https://github.com/YouFoundJK/ObsiTeXcore/commits/0.0.1


Usage

  1. Update or install the plugin via Obsidian Community Plugins (or manually place main.js, manifest.json, and styles.css in .obsidian/plugins/obsitexcore/).
  2. Enable the plugin and restart/reload Obsidian to ensure all editor extensions (such as equation numbering, hover popups, and TikZ renderers) load successfully.
  3. Configure your preferences under the ObsiTeXcore settings tab:
    • Set up custom Zotero clean directories.
    • Register your custom document shortcuts.
    • Map hotkeys for your custom LaTeX snippets.
  4. Write equations using $$...$$ blocks, tag them using a % id: eq-name comment before the closing $$, and reference them instantly using \eqref!