Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/raineszm/obsidian-latex-environments
Quickly insert and change latex environments within math blocks in Obsidian.
https://github.com/raineszm/obsidian-latex-environments
obsidian-md obsidian-plugin
Last synced: 3 months ago
JSON representation
Quickly insert and change latex environments within math blocks in Obsidian.
- Host: GitHub
- URL: https://github.com/raineszm/obsidian-latex-environments
- Owner: raineszm
- License: mit
- Created: 2020-11-04T23:57:39.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-10-19T09:56:47.000Z (about 1 year ago)
- Last Synced: 2024-10-09T10:44:54.795Z (3 months ago)
- Topics: obsidian-md, obsidian-plugin
- Language: TypeScript
- Homepage:
- Size: 6.09 MB
- Stars: 59
- Watchers: 3
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# obsidian-latex-environments
[![](https://img.shields.io/github/v/release/raineszm/obsidian-latex-environments?style=for-the-badge)](https://github.com/raineszm/obsidian-latex-environments/releases/latest)
![](https://img.shields.io/github/commits-since/raineszm/obsidian-latex-environments/latest?style=for-the-badge)
![](https://img.shields.io/github/manifest-json/minAppVersion/raineszm/obsidian-latex-environments?color=red&label=Min%20Obsidian%20Version&style=for-the-badge)
![](https://img.shields.io/github/downloads/raineszm/obsidian-latex-environments/total?style=for-the-badge)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](#license)> Quickly insert and change latex environments within math blocks in Obsidian.
**The internals have been rewritten for version 0.3.0. See Version 0.3.0 rewrite below.**
## Installation
If you have Obsidian version 0.9.8 or greater:
1. Open the options pane
1. Go to `Third-party plugins`
1. Ensure that `safe-mode` is *off*. (**WARNING: Please verify for yourself the safety of any plugins before using them.**)
1. Click `Browse` next to Community Plugins
1. Search for `Latex Environments`
1. Click `Install`
1. Go back to the `Third-party plugins` page and enable `Latex Environments`To update simply go back to the `Third-Party plugins` page for `Latex Environments` and click `Update`.
### Manual Installation
To manually install
1. download the latest `zip`from the [latest Github Release](https://github.com/raineszm/obsidian-latex-environments/releases/latest)
1. unzip the contents into the `.plugins/obsidian-latex-environments` subdirectory of your vault.
1. reload obsidian
1. go into settings > third party plugins and activate obsidian-latex-environmentsFor details see [the forums](https://forum.obsidian.md/t/plugins-mini-faq/7737).
## Usage
![](latexenv.gif)
### Commands
This plugin currently provides 3 commands, which do not have default bindings.
Both commands only work when the cursor is inside a math block.
Both commands will also query for the name of the environment.#### Insert Environment
Insert a new LaTeX environment at the cursor.
**With a selection** inserts a new LaTeX environment around the selection.
0.#### Change Environment
Change the name of the surrounding LaTeX environment.
*If the cursor is on a `\begin` or `\end`, it is the corresponding environment that will be changed.*
### Delete Environment
Remove the innermost LaTeX environment enclosing the cursor.
## Version 0.3.0 Rewrite
In order to support the Live Preview feature of obsidian the internals of this plugin needed to be rewritten.
The aim is to leave functionality unaffected but there may be some differences from previous versions.
Please file a bug report if you discover something that worked with 0.2.0 but not 0.3.0## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.Please make sure to update tests as appropriate.
## License
[MIT](https://choosealicense.com/licenses/mit/)