https://github.com/MartinCornelius/reword.nvim
A lightweight Neovim plugin to quickly find and swap synonyms while writing - without ever leaving Neovim.
https://github.com/MartinCornelius/reword.nvim
Last synced: 17 days ago
JSON representation
A lightweight Neovim plugin to quickly find and swap synonyms while writing - without ever leaving Neovim.
- Host: GitHub
- URL: https://github.com/MartinCornelius/reword.nvim
- Owner: MartinCornelius
- License: mit
- Created: 2025-05-28T14:36:15.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-06-04T15:48:52.000Z (24 days ago)
- Last Synced: 2025-06-04T21:21:39.425Z (24 days ago)
- Language: Lua
- Size: 10.7 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-neovim-pluginlist - MartinCornelius/reword.nvim - commit/MartinCornelius/reword.nvim)  (Other Standard Feature Enhancement / Dictionary)
README
# reword.nvim
**reword.nvim** is a lightweight Neovim plugin for writers, developers, and note-takers who want fast, in-editor synonym and definition lookup — without breaking flow.
> No GUI pop-ups. No switching tabs. Just language tools where you write.
### Synonym popup
Here’s how the plugin shows synonyms for the word **explanation**:
### Definition popup
Definition view for the word **explanation**:
---
## Features
- Quickly find synonyms or definitions for any word under the cursor
- Displays results in a floating window (non-intrusive)
- Uses [Free Dictionary API](https://dictionaryapi.dev/) — no API key required
---
## Requirements
- Neovim `0.8+`
- Internet connection (temporarily required)
- [curl](https://curl.se/) available in your system path
---
## Installation
Using [lazy.nvim](https://github.com/folke/lazy.nvim):
```lua
{
"martincornelius/reword.nvim",
config = function()
require("reword").setup({
persist = true, -- Enable persistent local cache (default: true)
})
end
}
```
---
## Usage
| Keybinding | Action |
| ------------ | ---------------- |
| `rw` | Show synonyms |
| `rd` | Show definitions |
The follow commands are also available:
- `:Reword` Show synonyms
- `:RewordDefine` Show definitions
- `:RewordClearCache` Clear the synonym/definition cache
---
## Caching
To improve performance and reduce repeated network API calls:
- Results are cached **in memory** by default
- If `persist = true` (default), cache is also stored **to disk** (across sessions)
- You can **disable persistence** via setup:
```lua
require("reword").setup({ persist = false })
```
### Clearing the cache
If you want to clear the cache (memory + disk):
```lua
:RewordClearCache
```
or you can manually delete the file `reword_cache.json` inside your neovim data folder.
---
## Acknowledgments
This plugin uses the free [Free Dictionary API](https://dictionaryapi.dev/) for definitions and synonyms.