Sentence Boundary Detection in javascript for node.
Clone or download
Latest commit 0570600 Aug 13, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark Version bump to v1.0.13 Mar 5, 2018
dist Tiny readme update Aug 13, 2018
lib Tiny readme update Aug 13, 2018
test Tiny readme update Aug 13, 2018
.gitignore Allow html boundaries to force sentence splitting Apr 7, 2016
LICENSE Added some additional checks and abbreviation changes Jan 16, 2015
Makefile add demo page May 8, 2015 Tiny readme update Aug 13, 2018
index.html Merge Dec 23, 2015
package.json 1.0.14 Aug 13, 2018
yarn.lock Include the actual yarn lock Aug 13, 2018

Sentence Boundary Detection (SBD)

Split text into sentences with a vanilla rule based approach (i.e working ~95% of the time).

  • Split a text based on period, question- and exclamation marks.
    • Skips (most) abbreviations (Mr., Mrs., PhD.)
    • Skips numbers/currency
    • Skips urls, websites, email addresses, phone nr.
    • Counts ellipsis and ?! as single punctuation


Use npm or yarn:

$ npm install sbd

$ yarn add sbd

How to

var tokenizer = require('sbd');

var optional_options = {};
var text = "On Jan. 20, former Sen. Barack Obama became the 44th President of the U.S. Millions attended the Inauguration.";
var sentences = tokenizer.sentences(text, optional_options);

// [
//  'On Jan. 20, former Sen. Barack Obama became the 44th President of the U.S.',
//  'Millions attended the Inauguration.',
// ]

Optional options

var options = {
    "newline_boundaries" : false,
    "html_boundaries"    : false,
    "sanitize"           : false,
    "allowed_tags"       : false,
    "preserve_whitespace" : false,
    "abbreviations"      : null
  • newline_boundaries, force sentence split at newlines
  • html_boundaries, force sentence split at specific tags (br, and closing p, div, ul, ol)
  • sanitize: If you don't expect nor want html in your text.
  • allowed_tags: To sanitize html, the library santize-html is used. You can pass the allowed tags option.
  • preserve_whitespace: Preserve the literal whitespace between words and sentences (otherwise, internal spaces are normalized to a single space char, and inter-sentence whitespace is omitted). Preserve whitespace has no effect if either newline_boundaries or html_boundaries is specified.
  • abbreviations: list of abbreviations to override the original ones for use with other languages. Don't put dots in your custom abbreviations.


You can run unit tests with npm test.

If you feel something is missing, you can open an issue stating the problem sentence and desired result. If code is unclear give me a @mention. Pull requests are welcome.

Building the (minified) scripts

npm install -g browserify

npm run-script build