Skip to content

markahesketh/write-good-obsidian

Repository files navigation

Write Good

An Obsidian plugin that integrates write good, a linter for English prose and improving writing style.

Example

Features

  • Identifies common writing issues in your notes
  • Offers suggestions to improve clarity and style, including:
    • Passive voice: Highlights use of passive voice
    • Lexical illusions: Detects repeated words
    • Sentence starts with "So": Flags sentences that start with "So"
    • Sentence starts with "There is/are": Flags sentences that start with "There is" or "There are"
    • Weasel words: Detects words like "many", "various", "very"
    • Adverbs: Highlights adverbs (words ending in -ly)
    • Wordy phrases: Flags wordy phrases that can be simplified
    • Clichés: Detects cliches
    • E-Prime: Flags use of "to be" verbs (E-Prime style)
  • Toggle checks per note via the command palette or a custom hotkey

Settings

  • Enabled by default: Automatically check newly created or opened notes
  • Configurable checks: Turn individual checks on or off (e.g., passive voice, adverbs, etc.)

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins and turn off Safe Mode
  3. Click Browse and search for "Write Good"
  4. Install the plugin
  5. Enable the plugin in your Community Plugins settings

Manual Installation

  1. Navigate to the latest release from the Releases page
  2. Download main.js, manifest.json, and style.css from the latest release
  3. Move these files into your Obsidian vault's .obsidian/plugins/write-good/ directory
  4. Reload Obsidian
  5. Enable the plugin in your Community Plugins settings

Usage

  1. Open any note in your vault
  2. Writing suggestions will automatically appear as you type

Development

  1. Clone this repository to your machine
  2. Run bin/npm install to install dependencies
  3. Run bin/npm run dev to start compilation in watch mode
  4. Copy or symlink the repository to your Obsidian vault's plugins folder: .obsidian/plugins/write-good-obsidian/

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/markahesketh/write-good-obsidian.

License

This plugin is available as open source under the terms of the MIT License.

About

Obsidian plugin to help improve writing style

Resources

License

Stars

Watchers

Forks

Packages

No packages published