Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
D

dedent

> 编程语言
Open source

⬅️ ES6 string tag that strips indentation from multi-line strings.

1.2K stars0 likes0 views
WebsiteGitHub

About

⬅️ ES6 string tag that strips indentation from multi-line strings.

dedent

A string tag that strips indentation from multi-line strings. ⬅️

Usage

bash
npm i dedent
…
A string that gets so long you need to break it over
multiple lines. Luckily dedent is here to keep it
readable without lots of spaces ending up in the string
itself.

Leading and trailing lines will be trimmed, so you can write something like
this and have it work as you expect:

	* how convenient it is
	* that I can use an indented list
		- and still have it do the right thing

That's all.

Wait! I lied. Dedent can also be used as a function.

Options

You can customize the options dedent runs with by calling its withOptions method with an object:

javascript
import dedent from 'dedent';

dedent.withOptions({ /* ... */ })`input`;
dedent.withOptions({ /* ... */ })(`input`);

options returns a new dedent function, so if you'd like to reuse the same options, you can create a dedicated dedent function:

javascript
import dedent from 'dedent';

const dedenter = dedent.withOptions({ /* ... */ });

dedenter`input`;
dedenter(`input`);

alignValues

When an interpolation evaluates to a multi-line string, only its first line is placed where the ${...} appears. Subsequent lines keep whatever indentation they already had inside that value (often none), so they can appear “shifted left”.

Enable alignValues to fix that visual jump. When true, for every multi-line interpolated value, each line after the first gets extra indentation appended so it starts in the same column as the first line.

javascript
import dedent from "dedent";

const list = dedent`
	- apples
	- bananas
	- cherries
`;

const withoutAlign = dedent`
	List without alignValues (default):
		${list}
	Done.
`;

const withAlign = dedent.withOptions({ alignValues: true })`
	List with alignValues: true
		${list}
	Done.
`;

console.log(withoutAlign);
console.log("---");
console.log(withAlign);
List without alignValues (default):
	- apples
- bananas
- cherries
Done.
---
List with alignValues: true
	- apples
	- bananas
	- cherries
Done.

escapeSpecialCharacters

JavaScript string tags by default add an extra \ escape in front of some special characters such as $ dollar signs. dedent will escape those special characters when called as a string tag.

If you'd like to change the behavior, an escapeSpecialCharacters option is available. It defaults to:

  • false: when dedent is called as a function
  • true: when dedent is called as a string tag
javascript
import dedent from "dedent";

// "$hello!"
dedent`
	$hello!
`;

// "\$hello!"
dedent.withOptions({ escapeSpecialCharacters: false })`
	$hello!
`;

// "$hello!"
dedent.withOptions({ escapeSpecialCharacters: true })`
	$hello!
`;

For more context, see Feature: Add an option to disable special character escaping.

trimWhitespace

By default, dedent will trim leading and trailing whitespace from the overall string.

This can be disabled by setting trimWhitespace: false.

javascript
import dedent from "dedent";

// "hello!"
dedent`
	hello! 
`;

// "\nhello! \n"
dedent.withOptions({ trimWhitespace: false })`
	hello! 
`;

// "hello!"
dedent.withOptions({ trimWhitespace: true })`
	hello! 
`;

License

MIT

Contributors

Adrian Jost

Andri Möll

Benny Powers - עם ישראל חי!

Craig Spence

Desmond Brand

Gareth Jones

Gray Zhang

Haroen Viaene

Hyeseong Kim

John L. Armstrong IV

Josh Goldberg ✨

Pratap Vardhan

Simon Lydell

Yusuke Iinuma

Yves M.

d07riv

mizdra

sirian

This package was templated with create-typescript-app.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

TypeScriptdedentes2015es6javascript

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言