# microsoft-capitalize

> Sentence-style capitalization in titles and headings based on Microsoft Styleguide

Latest version **1.0.8** (published 2026-04-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install microsoft-capitalize
pnpm add microsoft-capitalize
yarn add microsoft-capitalize
bun add microsoft-capitalize
```

## Health

**Score 50/100 (C)** — status: active.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 1.0.8 |
| Published | 2026-04-14 |
| First published | 2020-05-07 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 10 |
| Dependencies | 0 |
| Unpacked size | 9.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 6 |
| Author | Kiko Beats |
| Maintainers | kikobeats |
| Keywords | capitalization, capitalize, microsoft, style, styleguide, title, titleize |

## Links

- npm: https://www.npmjs.com/package/microsoft-capitalize
- Repository: https://github.com/Kikobeats/microsoft-capitalize
- Issues: https://github.com/Kikobeats/microsoft-capitalize/issues
- npm.io page: https://npm.io/package/microsoft-capitalize

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.0.8 (latest) — 2026-04-14
- 1.0.7 — 2026-03-17
- 1.0.6 — 2026-01-08
- 1.0.5 — 2020-12-17
- 1.0.4 — 2020-12-17
- 1.0.3 — 2020-08-01
- 1.0.2 — 2020-07-24
- 1.0.1 — 2020-05-07
- 1.0.0 — 2020-05-07
- 0.0.2 — 2020-05-07
- 0.0.1 — 2020-05-07

## README

# microsoft-capitalize

<p align="center">
  <br>
  <img src="https://docs.microsoft.com/en-us/style-guide/welcome/media/index/writingstyleguidebanner.png" alt="microsoft-capitalize">
  <br>
</p>

![Last version](https://img.shields.io/github/tag/Kikobeats/microsoft-capitalize.svg?style=flat-square)
[![Coverage Status](https://img.shields.io/coveralls/Kikobeats/microsoft-capitalize.svg?style=flat-square)](https://coveralls.io/github/Kikobeats/microsoft-capitalize)
[![Bundlephobia](https://badgen.net/bundlephobia/minzip/microsoft-capitalize?style=flat-square)](https://bundlephobia.com/result?p=microsoft-capitalize)
[![NPM Status](https://img.shields.io/npm/dm/microsoft-capitalize.svg?style=flat-square)](https://www.npmjs.org/package/microsoft-capitalize)

> Sentence-style capitalization in titles and headings based on [Microsoft Styleguide](https://docs.microsoft.com/en-us/style-guide/capitalization).

- Capitalize the first word of a sentence.
- Be possible to omit specific exceptions.
- Use lowercase for everything else.

## Install

```bash
$ npm install microsoft-capitalize --save
```

## Usage

```js
const capitalize = require('microsoft-capitalize')

capitalize('Microlink CDN: Global Edge Cache')
// => 'Microlink CDN: Global edge cache'

// handling dot corner cases
capitalize('autopilot 2.5')
// => 'Autopilot 2.5'

// passing exceptions
capitalize('JSON+LD & oEmbed', ['oEmbed'])
// => 'JSON+LD & oEmbed'
```

## API

### capitalize(input, [exceptions])

#### input

*Required*<br>
Type: `string`

The input string to be capitalize.

#### exceptions

Type: `string[]`

A list of words to be excluded.

## License

**microsoft-capitalize** © [Kiko Beats](https://kikobeats.com), released under the [MIT](https://github.com/Kikobeats/microsoft-capitalize/blob/master/LICENSE.md) License.<br>
Authored and maintained by [Kiko Beats](https://kikobeats.com) with help from [contributors](https://github.com/Kikobeats/microsoft-capitalize/contributors).

> [kikobeats.com](https://kikobeats.com) · GitHub [Kiko Beats](https://github.com/Kikobeats) · X [@Kikobeats](https://x.com/Kikobeats)

---
_Source: https://npm.io/package/microsoft-capitalize · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._