This is a plugin for Obsidian which adds Grammarly support directly in your editor.
NOTE: This plugin is a work in progress. It will be submitted to "Community Plugins" at a later time.
Do not clone the repo or download it as zip. This is not how this plug-in is installed.
Quick starting guide for installing the plugin:
- Download obsidian-grammarly-plugin.zip from the latest release.
- Go to: https://github.com/simonpacis/obsidian-grammarly-plugin/releases
- Go to the latest release, click "Assets" and download the zip-file from here.
- Extract the file in a .obsidian/plugins folder in your Vault (.obsidian is probably hidden)
- Open Obsidian, go to "Community Plugins" and enable "Grammarly Plugin".
There are two ways to use this plugin.
- Click on the Grammarly logo in the left ribbon.
- Open the command palette and run the "Enable Grammarly" command.
Grammarly will now be enabled for the remainder of the session. At the moment you (generally) have to quit Obsidian to get rid of it.
Some themes change the way the Grammarly popover is positioned, and therefore it might be far off from where it is supposed to be. In the settings for the plugin it is possible to offset the popover (left and top) in pixels.
E.g. for the default Obsidian theme I have found a left offset of "320" and a top offset of "100" to be helpful.
Please note that the offset doesn't live-change. It is only applied the first time you "Enable Grammarly". You may have to restart Obsidian in between offset changes.
This plugin is pretty simple. It includes the Grammarly Editor SDK so that you get a Grammarly button in the lower left corner of your editor window. You also get underlines and the typical in-place substitutions that Grammarly provides.
If you're interested in further developing the plugin, you are more than welcome to do so and submit PR's.
Quick-start:
- Clone the repo
- Run
npm install
- Run
npm run dev
to generate main.js.
The plugin is based on the following unofficial developer docs: https://marcus.se.net/obsidian-plugin-docs/getting-started/create-your-first-plugin
Obsidian Grammarly Plugin is far from done. This is more of a proof-of-concept version at this stage. Here are the planned features before submission to "Community Plugins" will be made.
- Support for logging in to your own Grammarly account (for premium features)
- Style customizations
- Custom settings
- Ability to disable Grammarly
- Hide/move "Grammarly-powered editor" tooltip
- Test on Windows
- Test on macOS
- Test on iOS
- Test on Android
- Grammarly fails in files with embedded PDF's (see issue #2)