Spell Checking Markdown Documents
by John Vincent
Posted on June 1, 2018
Discussion about spell checking Markdown documents.
Markdown Spell Checker
I chose to use this Markdown Spell Checker
npm i markdown-spellcheck --save-dev
Although markdown-spellcheck
has the ability to parse out files in a file system, I found it to be very cumbersome.
Thus I built a script md-spell-checker
in the root directory of the project.
#!/bin/sh
#
# script to spell check markdown files
#
PARAM="$1"
#
if [ -z "$PARAM" ]; then
echo "Spell Checker for all Markdown Files"
for FILE in `find . \( -path ./node_modules -o -path ./destination -o -path ./Not-in-use \) -prune -o -name '*.md' -print`
do
echo "Spell Checking Markdown file $FILE"
./node_modules/markdown-spellcheck/bin/mdspell -r -n -a --en-us $FILE
echo "Completed Spell Checking Markdown file $FILE"
echo " "
done
else
echo "Spell Checking Markdown file $PARAM"
./node_modules/markdown-spellcheck/bin/mdspell -r -n -a --en-us $PARAM
fi
Notice the code to ignore directories I do not wish to spell check. Modify for your own needs.
To spell check only one file
./md-spell-checker {your-file}
Added to package.json
"scripts": {
"spelling": "./md-spell-checker"
},
Add words to be considered valid by adding them, one word per line, to .spelling
.
To spell check all markdown files
npm run spelling