Repository files navigation

Reads markdown files and spellchecks them, usingopen source Hunspell dictionary files.

There are two modes, interactive fixing, which will allow you to fix mistakes and add exceptions to a custom dictionary and a report mode which will just report the list of errors.

# installnpm i markdown-spellcheck -g# run in interactive modemdspell "**/*.md"# see help & optionsmdspell

Multiple patterns can be used on the command line and can use! for negation. e.g.

mdspell '**/*.md' '!**/node_modules/**/*.md'

Ignores numbers like1.2 and1,2.4.

Ignores acronyms likeNPM. Also ignores numbers. Does not ignore single letters e.g.U.

Suggestions are slow at present, so use this to remove them.

Use the American English dictionary. We default to British English but will change in the next major to American.

Use the British English dictionary. We default to British English but will change in the next major to American.

Use the Australian English dictionary.

Use the Spanish dictionary.

Specify a custom Hunspell dictionary to load. The passed filename should not include a file extension andmarkdown-spellcheck will attempt to load the file with.aff and.dic extensions.

The default interactive mode shows you the context of the spelling mistake and gives you options with what to do about it. E.g.

Spelling - readme.md shows you the context of the speling mistake and gives you options?   (Use arrow keys)  Ignore  Add to file ignores  Add to dictionary - case insensitive> Enter correct spelling  spelling  spieling  spewing  selling  peeling

Wherespeling will be highlighted in red.

• "Ignore" will ignore that word and not ask about it again in the current run. If you re-run the command again though, it will appear.
• "Add to file ignores" will ignore the word in this file only.
• "Add to dictionary - case insensitive" will add to the dictionary for all files and match any case. e.g. with the wordMicrosoft bothMicrosoft andmicrosoft would match.
• "Add to dictionary - case sensitive" will add to the dictionary for all files and match the case that has been used. e.g. with the wordMicrosoft, the wordmicrosoft will not match.

All exclusions will be stored in a.spelling file in the directory from which you run the command.

Using the--target-relative (-t) option will augment the shared.spelling file with a relative.spelling file (sibling of the.md file) and give you the additional options with the interactive mode:

• "Add to file ignores" will be replaced with "[Relative] Add to file ignores". There is no need to add file ignores into the shared.spelling file.
• "[Relative] Add to dictionary - case insensitive" will add to the dictionary for all files within the current.md file and match any case.
• "[Relative] Add to dictionary - case sensitive" will add to the dictionary for all files within the folder of the current.md file.

Using the--report (-r) option will show a report of all the spelling mistakes that have been found. This mode is useful for CI build reports.

The.spelling file is self documenting as it includes...

# markdown-spellcheck spelling configuration file# Format - lines begining # are comments# global dictionary is at the start, file overrides afterwards# one word per line, to define a file override use ' - filename'# where filename is relative to this configuration file

Add to yourpackage.json and then run in report mode. If new spelling errors occur that are not ignored in the.spelling file, a error exit code will be set.

For instance, if yourpackage.json has:

  "scripts": {    "test": "gulp test"  },

Change it to...

  "scripts": {    "test": "mdspell -r **/*.md && gulp test"  },

Seegrunt-mdspell.

Seehttps://github.com/marcoagpinto/aoo-mozilla-en-dict.

Missing word? Raise it athttps://github.com/marcoagpinto/aoo-mozilla-en-dict/issues.

Seehttp://wordlist.aspell.net/dicts/.

Missing word? Raise it athttps://github.com/kevina/wordlist/issues.