https://github.com/Flet/github-slugger

:octocat: Generate a slug just like GitHub does for markdown headings.
https://github.com/Flet/github-slugger

Last synced: about 2 months ago
JSON representation

:octocat: Generate a slug just like GitHub does for markdown headings.

• Host: GitHub
• URL: https://github.com/Flet/github-slugger
• Owner: Flet
• License: isc
• Created: 2015-09-22T20:18:01.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2023-09-30T07:31:44.000Z (12 months ago)
• Last Synced: 2024-05-22T09:42:57.877Z (4 months ago)
• Language: JavaScript
• Size: 137 KB
• Stars: 331
• Watchers: 6
• Forks: 32
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# github-slugger

[![npm][npm-image]][npm-url]

[![Build][build-badge]][build]

[npm-image]: https://img.shields.io/npm/v/github-slugger.svg?style=flat-square

[npm-url]: https://www.npmjs.com/package/github-slugger

[build-badge]: https://github.com/Flet/github-slugger/workflows/main/badge.svg

[build]: https://github.com/Flet/github-slugger/actions

Generate a slug just like GitHub does for markdown headings. It also ensures slugs are unique in the same way GitHub does it. The overall goal of this package is to emulate the way GitHub handles generating markdown heading anchors as close as possible.

This project is not a markdown or HTML parser: passing `alpha *bravo* charlie`

or `alpha bravo charlie` doesn’t work.

Instead pass the plain text value of the heading: `alpha bravo charlie`.

## Install

```

npm install github-slugger

```

## Usage

```js

import GithubSlugger from 'github-slugger'

const slugger = new GithubSlugger()

slugger.slug('foo')

// returns 'foo'

slugger.slug('foo')

// returns 'foo-1'

slugger.slug('bar')

// returns 'bar'

slugger.slug('foo')

// returns 'foo-2'

slugger.slug('Привет non-latin 你好')

// returns 'привет-non-latin-你好'

slugger.slug('😄 emoji')

// returns '-emoji'

slugger.reset()

slugger.slug('foo')

// returns 'foo'

```

Check [`test/fixtures.json`](test/fixtures.json) for more examples.

If you need, you can also use the underlying implementation which does not keep

track of the previously slugged strings (not recommended):

```js

import GithubSlugger, {slug} from 'github-slugger'

slug('foo bar baz')

// returns 'foo-bar-baz'

slug('foo bar baz')

// returns the same slug 'foo-bar-baz' because it does not keep track

```

## Contributing

Contributions welcome! Please read the [contributing guidelines](CONTRIBUTING.md) first.

## License

[ISC](LICENSE)