Thanks to visit codestin.com
Credit goes to github.com

Skip to content

tomherni/quote-quote

Repository files navigation

“QuoteQuote”

Convert boring, straight quotes (" and ') to beautiful, typographically correct curly quotes — also known as smart quotes.

Highlights

  • Converts straight single/double quotes to curly quotes.
  • Converts straight quotes used as primes to prime symbols.
  • Handles contractions, possessives and abbreviated years.
  • Lightweight, zero dependencies, modern, and tree-shakeable.

Installing

Install with a package manager such as npm, pnpm or yarn.

npm install quote-quote

Example

ESM

import { convert } from 'quote-quote';

const text = `"That's a 'magic' shoe."`;

convert(text); // “That’s a ‘magic’ shoe.”

CommonJS

const { convert } = require('quote-quote');

const text = `"That's a 'magic' shoe."`;

convert(text); // “That’s a ‘magic’ shoe.”

API Summary

convert() Convert straight quotes to curly quotes.
convertMarkdown() Convert straight quotes to curly quotes in Markdown.

API

convert(text[, options])

Convert straight quotes to curly quotes.

text String – the text that may contain straight quotes
[options] Object – optional options
[options.ellipsis] Boolean – whether to also convert "..." to an ellipsis
Returns String
Throws TypeError – if text is not a String or options not an Object

Example:

import { convert } from 'quote-quote';

const text = `"That's a 'magic' shoe."`;

convert(text); // “That’s a ‘magic’ shoe.”

Example using options:

import { convert } from 'quote-quote';

const text = `"That's a 'magic' shoe..."`;

convert(text, { ellipsis: true }); // “That’s a ‘magic’ shoe…”

convertMarkdown(text[, options])

Convert straight quotes to curly quotes in text formatted as Markdown. This means that quotes inside code are not converted.

text String – the text that may contain straight quotes
[options] Object – optional options
[options.ellipsis] Boolean – whether to also convert "..." to an ellipsis
Returns String
Throws TypeError – if text is not a String or options not an Object

Example:

import { convertMarkdown } from 'quote-quote';

const text = '"Hello `"world"`" they said.';

convertMarkdown(text); // “Hello `"world"`” they said.

Example using options:

import { convertMarkdown } from 'quote-quote';

const text = '"Hello `"world"`" they said...';

convertMarkdown(text, { ellipsis: true }); // “Hello `"world"`” they said…

Versioning

This project follows SemVer (Semantic Versioning).

About

Convert boring, straight quotes to beautiful, typographically correct curly quotes.

Topics

Resources

License

Contributing

Stars

Watchers

Forks