Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

gatsby-remark-widows

Automatically adds a non-breaking space between the last 2 words in a text node parsed by gatsby-transformer-remark. This ensures there isn’t a “widow”, or single word left at the end of a wrapped sentance/paragraph.


Nulla et exercitation excepteur ullamco
eiusmod.

Lorem ipsum dolor sit Lorem irure aliquip magna labore qui
velit officia aliquip deserunt aliqua. Aute tempor fugiat nisi
adipisicing et aliquip sint minim cupidatat elit consequat
et.

:arrow_down:

Nulla et exercitation excepteur
ullamco eiusmod.

Lorem ipsum dolor sit Lorem irure aliquip magna labore qui
velit officia aliquip deserunt aliqua. Aute tempor fugiat nisi
adipisicing et aliquip sint minim cupidatat elit
consequat et.


Install

npm install --save gatsby-remark-widows

Currently uses \u00a0 to insert a space so you don’t need to use dangerouslySetInnerHTML.
Your browser should™ render that as  

Warning: This currently effects every text node. You can limit by word count via the options.

How to use

// In your gatsby-config.js
plugins: [
  {
    resolve: `gatsby-transformer-remark`,
    options: {
      // Probably best to place after other plugins
      plugins: [`gatsby-remark-widows`],
    },
  },
];

Options

You may set some options to configure which text nodes are processed by their word count. Defaults to minLength: 4

// In your gatsby-config.js
plugins: [
  {
    resolve: `gatsby-transformer-remark`,
    options: {
      plugins: [
        {
          resolve: 'gatsby-remark-widows',
          options: {
            minLength: 4, // default
            maxLength: null, // default
          },
        },
      ],
    },
  },
];

Todo

  • Add more options
  • Add tests
© 2023 Gatsby, Inc.