---
url: /docs/guide/usage/formatter/beyond-prettier.md
---

# Beyond Prettier

Oxfmt uses Prettier's output as its baseline.
On top of that, it ships features that Prettier does not have, or only has through plugins.

For intentional output differences that fix Prettier bugs, see [Known divergences](./migrate-from-prettier#known-divergences).

## Built-in plugins

Popular Prettier plugins are built in, with no extra install:

* [`sortImports`](./sorting#sort-imports)
  * Based on `eslint-plugin-perfectionist/sort-imports`
  * Disabled by default
* [`sortTailwindcss`](./sorting#sort-tailwind-css-classes)
  * Based on `prettier-plugin-tailwindcss`
  * Disabled by default
* [`sortPackageJson`](./sorting#sort-package-json-fields)
  * Based on `prettier-plugin-packagejson`
  * Enabled by default
* [`jsdoc`](./config-file-reference#jsdoc)
  * Based on `prettier-plugin-jsdoc`
  * Disabled by default

`oxfmt --migrate prettier` converts their options too.
See [Migrate from Prettier](./migrate-from-prettier#step-3-migrate-configuration).

## JavaScript / TypeScript

### Test calls

Like Prettier, Oxfmt keeps a test call's description and callback on one line, even if it exceeds `printWidth`.
Prettier does this only for Jest / Jasmine / Playwright style calls (`it`, `describe`, `test` with `.only` / `.skip`, etc.).
Oxfmt also recognizes:

* Vitest: `.concurrent`, `.sequential`, `.fails`, `.shuffle`, `bench`
* `Deno.test`

```js
// Oxfmt, printWidth: 80
it.concurrent("does something really long and descriptive with the formatter output", async () => {
  expect(1).toBe(1);
});

// Prettier, printWidth: 80
it.concurrent(
  "does something really long and descriptive with the formatter output",
  async () => {
    expect(1).toBe(1);
  },
);
```

## TOML

### Native support

`.toml` files are formatted natively.
Prettier needs a plugin for TOML.

### TOML in Markdown

`+++` front matter and `toml` code blocks in Markdown are formatted too:

````md
<!-- input -->
+++
a   =   1
+++

```toml
b   =  [1,2]
```

<!-- Oxfmt -->
+++
a = 1
+++

```toml
b = [1, 2]
```
````

Prettier leaves both as-is.

## Markdown

### Container directives

`:::` container directives (VitePress, Docusaurus, remark-directive, Pandoc) are parsed as blocks.
Fence lines are kept as written, and only the content inside is formatted.

```md
<!-- input -->
:::warning
Some **text** that is
long.
:::

<!-- Oxfmt, proseWrap: "always" -->
:::warning
Some **text** that is long.
:::

<!-- Prettier, proseWrap: "always" -->
:::warning Some **text** that is long. :::
```

Prettier treats the fences as plain text and merges them into the paragraph, which breaks the container.

## Options

* [`insertFinalNewline`](./config-file-reference#insertfinalnewline)
  * Whether to insert a final newline at the end of the file.
  * Also respects `insert_final_newline` in `.editorconfig`.