This is a plugin for Obsidian.md that integrates LanguageTool to provide advanced Grammar and Spell Checking.
⚠️ This Plugin is in maintenance mode
It does everything I want it to do, unless it breaks I do not have intentions to update it further.
Feel free to open Issues/Suggestions but please understand that I'm devoting my free time to other things.
You are however welcome to create Pull Request and I will review/merge them and release new versions accordingly.
Note: if you are worried about the privacy of your notes you should selfhost languagetool, whether it be locally on your pc or on a server Docker Image
If you decide to self host the service, you need to change the link in the configuration accordingly.
- In Obsidian, under Settings / Community plugins, disable "Safe mode" (read the safety warning).
- Click the Browse button for Community plugins.
- In the top-left search field, search for "LanguageTool Integration". Click the Install button.
- After the installation is successful, click Enable to enable the plugin.
After installing and enabling the plugin, you can set up three hotkeys (under Settings / Hotkeys) which can be found under the description "LanguageTool Integration" through the Filter search field, to find specific hotkey functions quicker. Make sure that there is no conflict with existing hotkeys and the spellcheck function within Obsidian, if enabled (Settings / Editor / Spellcheck ON/OFF).
- "Check Text" checks the whole document in view, if no text is selected. If you want to check only a word, sentence or paragraph, select the text of choice and press the keyboard shortcut you have previously setup. Click on the red underlined word that LanguageTool identified as a possible spelling mistake to get corrective suggestions in a popover window, with the option to add the word to a personal dictionary.
- "Clear Suggestions" clears the document or selected text of all red underlines from words or passages that were not corrected or changed.
- "Toggle Automatic Checking" toggles ON/OFF the automatic spellchecking function as you write or change the document's contents.
LanguageTool tries to auto-detect the language used. Selecting a specific language (under Settings / Plugin Options / LanguageTool Integration / Static language) is normally not necessary. This feature enables the user to spellcheck in different languages within the same document (e.g. a dissertation written in English with quotes in a foreign language), which is ordinarily not possible with the built-in spellcheck function of Obsidian.
add the tag lt-ignore
to the frontmatter of a file to ignore it from being spellchecked. All spellchecks, even manual ones, will be ignored.
We finally support LanguageTool Premium.
To use the premium features, you (obviously) need a Premium Account, and an API key. You can generate your API key at https://languagetool.org/editor/settings/access-tokens
Configure your email, API key, and the new URL (https://api.languagetoolplus.com) in the plugin settings
- Copy over
main.js
,styles.css
,manifest.json
from the latest release to your vaultVaultFolder/.obsidian/plugins/obsidian-languagetool-plugin/
.