@sindresorhus/slugify

What is @sindresorhus/slugify?

@sindresorhus/slugify is a simple and efficient npm package used to convert strings into URL-friendly slugs. It handles various edge cases, such as special characters, spaces, and diacritics, making it a reliable choice for generating slugs from user input or other text data.

What are @sindresorhus/slugify's main functionalities?

Basic Slugification

This feature converts a basic string into a URL-friendly slug by replacing spaces with hyphens and converting the text to lowercase.

const slugify = require('@sindresorhus/slugify');
const slug = slugify('Hello World!');
console.log(slug); // 'hello-world'

Custom Replacement Characters

This feature allows you to customize the separator character used in the slug, such as using an underscore instead of a hyphen.

const slugify = require('@sindresorhus/slugify');
const slug = slugify('Hello World!', { separator: '_' });
console.log(slug); // 'hello_world'

Handling Diacritics

This feature removes diacritics from characters, ensuring that the resulting slug is composed of standard ASCII characters.

const slugify = require('@sindresorhus/slugify');
const slug = slugify('Crème brûlée');
console.log(slug); // 'creme-brulee'

Custom Replacement Map

This feature allows you to define custom replacements for specific characters or strings, providing greater control over the slugification process.

const slugify = require('@sindresorhus/slugify');
const slug = slugify('foo@bar', { customReplacements: [['@', 'at']] });
console.log(slug); // 'foo-at-bar'

Other packages similar to @sindresorhus/slugify

slug

The 'slug' package is another popular choice for generating URL-friendly slugs. It offers similar functionality to @sindresorhus/slugify, including handling special characters and diacritics. However, it provides more configuration options and supports transliteration for non-Latin characters.

speakingurl

The 'speakingurl' package is designed to create human-readable slugs from strings. It supports a wide range of languages and character sets, making it a versatile choice for internationalization. Compared to @sindresorhus/slugify, it offers more extensive language support and customization options.

limax

The 'limax' package is a slug generator that focuses on transliteration and supports multiple languages. It is similar to @sindresorhus/slugify in terms of basic functionality but provides additional features for handling non-Latin scripts and complex transliterations.

README

slugify

Slugify a string

Useful for URLs, filenames, and IDs.

Install

$ npm install @sindresorhus/slugify

Usage

const slugify = require('@sindresorhus/slugify');

slugify('I ♥ Dogs');
//=> 'i-love-dogs'

slugify('  Déjà Vu!  ');
//=> 'deja-vu'

slugify('fooBar 123 $#%');
//=> 'foo-bar-123'

Related

• filenamify - Convert a string to a valid safe filename

License

MIT © Sindre Sorhus