microsoft/typespec

---
id: formatter
title: Formatter
---

# Formatter

TypeSpec comes with a built-in formatter. The formatter can be used in different ways:

- [Via the cli](#via-the-cli)
- Via the vscode/vs extension
- As a prettier plugin

## Via the cli

Format all typespec files:

```bash
tsp format **/*.tsp
```

Validate that the files are formatted but don't format them. Useful for enforcing in CI.

```bash
tsp format --check **/*.tsp
```

## Via the VSCode or VS extension

When using the VS Code or Visual Studio extensions, the tsp formatter is automatically available.

Using the keyboard shortcut for formatting the document (`alt+shift+F` by default) when inside a TypeSpec file will format the document.

## Via prettier

Underneath the tsp formatter is a prettier plugin. If you already have a prettier configuration for formatting other languages it can be convenient to just have typespec plug in into this existing pipeline.

In your prettier config file, add:

```yaml
plugins:
  - "./node_modules/@typespec/prettier-plugin-typespec"
overrides: [{ "files": "*.tsp", "options": { "parser": "typespec" } }]
```