JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 12626
  • Score
    100M100P100Q133266F
  • License ISC

Spell-checks markdown files with an interactive CLI allowing automated spell checking.

Package Exports

  • markdown-spellcheck
  • markdown-spellcheck/es5/spell-config
  • markdown-spellcheck/es5/spellcheck

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (markdown-spellcheck) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Build Status Build status npm version Dependencies devDependency Status

Reads markdown files and spellchecks them, using OpenOffice hunspell files.

CLI Usage

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.

# install
npm i markdown-spellcheck -g

# run in interactive mode
mdspell "**/*.md"

# see help & options
mdspell

CLI Options

Ignore numbers (-n, --ignore-numbers)

Ignores numbers like 1.2 and 1,2.4.

Ignore acronyms (-a, --ignore-acronyms)

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

No suggestions (-x, --no-suggestions)

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

Interactive Mode

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

Where speling 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 word Microsoft both Microsoft and microsoft 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 word Microsoft, the word microsoft will not match.

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

Report Mode

Using the --report (-r) option will show you every mistake. You can get a summary with --report --summary or -rs.

.spelling files

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

Use To Stop Spelling Regressions

Usage with npm

Add to your package.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 your package.json has:

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

Change it to...

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

Usage in grunt

See grunt-mdspell.

Usage in gulp