Markdown-proofreader NPM

Markdown Proofreader

Motivation

Because during the COVID-19 quarantine I wrote tons of Markdown files (such as README.md). Mostly in bad english... I was looking for a simple solution to check the syntax and grammar of those notes.

Technologies

markdown-proofreader is built :

on top of Grammar Bot API for proofreading purpose
with Highland.js for handling streams
with fast-glob to match only markdown files
with eslint/prettier combo AirBnB flavor

Installation

Warning :

Markdown Proofreader requires you use git as version control software.

Run npm install markdown-proofreader.

How to use ?

Markdown Proofreader has currently two modes

Verification of files matching a glob
Verification of additions compared to the last commit (diff mode)

Files matching a glob (Default mode)

By default, Markdown proofreader will check all markdown files present in the repository.

Use --match flag to target specific files using a glob pattern.

Under the hood we are using Fast Glob to find pathnames that matched a provided pattern.

See fast-glob documentation to learn more about the syntax.

Diff mode

Working with new files

Write your next best-seller essai or the documentation of your anti COVID-19 software in plain Markdown
Track the changes (git add)
Run markdown-proofreader --diff-only
Get your report

Working with updated files

Update your files
Track the changes (git add)
Run markdown-proofreader --diff-only
Get your report

(only the updates will be considered, not the deletion)

How does it work ?

markdown-proofreader will perfom a git diff --cached on your markdown files, strip the markdown and send the content to GrammarBot API.

CLI options

--diff-only : used to work in 'only-diff mode' {optional}
--match : used to provide a glob pattern to target only specific file (optional)

FAQ

Do you work for GrammarBot ?

Nope. I'm not working for GrammarBot or get any money/goodies/support from them. I just did some research on DuckDuckGo and found that API. I will try to integrate other APIs in a future release.