prettier-plugin-embed 0.6.0 → 0.7.1

package/README.md

@@ -56,7 +56,7 @@ Install Prettier 3 in the project that runs formatting. The consumer supplies th
 
 Install the formatter plugin for each embedded language you use as a separate project dependency; the [Language-Specific Options](#language-specific-options) section shows which integrations require one.
 
-Choose a Prettier version accepted by this plugin and every loaded language plugin. Each language plugin declares its own Prettier peer range.
+Choose Prettier and runtime versions supported by every loaded language plugin. Parser availability and syntax support follow the installed formatter version.
 
 <details>
 <summary>Dependency resolution in strict installations</summary>
@@ -129,7 +129,7 @@ Set [`embeddedLanguageFormatting`](https://prettier.io/docs/options#embedded-lan
 
 This plugin uses Prettier's built-in parsers and existing [language plugins](https://prettier.io/docs/plugins#official-plugins), adding the integration needed to format their languages inside template literals.
 
-Install and load the formatter plugin for each additional language you use. For example, embedded XML requires both this plugin and [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml). The [Language-Specific Options](#language-specific-options) section lists the required plugins.
+Install and load the formatter plugin for each additional language you use. For example, embedded XML requires both this plugin and [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml#readme). The [Language-Specific Options](#language-specific-options) section lists the required plugins.
 
 A preceding [block comment](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#block_comments) such as `` /* xml */ `...` `` or a [tag](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals#tagged_templates) such as `` xml`...` `` identifies the embedded language. Configure each language with `embedded<Language>Comments` and `embedded<Language>Tags`. A leading block comment is checked first; templates without one are matched by their tag.
 
@@ -154,29 +154,46 @@ Add comments or tags to `embeddedNoopComments` or `embeddedNoopTags` to preserve
 
 Supported embedded languages and their default comment/tag identifiers are:
 
+- [Astro](#astro): `astro`
 - [CSS](#css): `css`
+- [Dockerfile](#dockerfile): `dockerfile`, `containerfile`
 - [ES (ECMAScript/JavaScript)](#es-ecmascriptjavascript): `js`, `jsx`, `es`, `es6`, `mjs`, `cjs`, `pac`, `javascript`
+- [Gherkin](#gherkin): `gherkin`, `feature`
 - [GLSL](#glsl): `glsl`, `shader`
+- [Go Template](#go-template): `goTemplate`, `gotmpl`
 - [GraphQL](#graphql): `graphql`, `gql`
+- [Handlebars](#handlebars): `handlebars`, `hbs`
 - [HTML](#html): `html`, `xhtml`
+- [Hugo](#hugo): `hugo`, `hugoPost`
 - [INI](#ini): `ini`, `cfg`, `pro`
 - [Java](#java): `java`
+- [Jinja](#jinja): `jinja`, `jinja2`, `j2`
 - [JSON](#json): `json`, `jsonl`
 - [JSONata](#jsonata): `jsonata`
+- [JTE](#jte): `jte`
 - [LaTeX](#latex): `latex`, `tex`, `aux`, `cls`, `bbl`, `bib`, `toc`, `sty`
+- [Liquid](#liquid): `liquid`
 - [Markdown](#markdown): `md`, `markdown`
+- [Marko](#marko): `marko`
+- [Motoko](#motoko): `motoko`, `mo`
+- [Mustache](#mustache): `mustache`
 - [NGINX](#nginx): `nginx`
+- [Nunjucks](#nunjucks): `nunjucks`, `njk`
 - [Pegjs](#pegjs): `pegjs`, `peggy`, `peg`
 - [PHP](#php): `php`, `php5`
+- [PowerShell](#powershell): `powershell`, `ps1`
 - [Prisma](#prisma): `prisma`
 - [Properties](#properties): `properties`
 - [Pug](#pug): `pug`, `jade`
 - [Ruby](#ruby): `ruby`
 - [Sh (Shell)](#sh-shell): `sh`
+- [Solidity](#solidity): `solidity`, `sol`
 - [SQL](#sql): `sql`
+- [Svelte](#svelte): `svelte`
 - [TOML](#toml): `toml`
 - [TS (TypeScript)](#ts-typescript): `ts`, `tsx`, `cts`, `mts`, `typescript`
 - [XML](#xml): `xml`, `opml`, `rss`, `svg`
+- [XQuery](#xquery): `xquery`, `xq`
 - [YAML](#yaml): `yaml`, `yml`
 
 <details open>
@@ -200,6 +217,22 @@ Click Here to Toggle
 
 This built-in option can override native embedded language formatting for the specified comments or tags, preserving their template literal content as written.
 
+#### Astro
+
+##### `embeddedAstroComments`
+
+- **Type**: `string[]`
+- **Default**: [`["astro"]`](./src/embedded/astro/options.ts)
+- **Description**: Block comments that identify embedded Astro in template literals. Requires the [`prettier-plugin-astro`](https://github.com/withastro/prettier-plugin-astro#readme) plugin.
+
+##### `embeddedAstroTags`
+
+- **Type**: `string[]`
+- **Default**: [`["astro"]`](./src/embedded/astro/options.ts)
+- **Description**: Tags that identify embedded Astro in template literals. Requires the [`prettier-plugin-astro`](https://github.com/withastro/prettier-plugin-astro#readme) plugin.
+
+Formatting embedded Astro requires the [`prettier-plugin-astro`](https://github.com/withastro/prettier-plugin-astro#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
 #### CSS
 
 ##### `embeddedCssComments`
@@ -226,6 +259,24 @@ This can override the native formatting behavior for embedded CSS language. If y
 
 If you want to specify different parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
+#### Dockerfile
+
+##### `embeddedDockerfileComments`
+
+- **Type**: `string[]`
+- **Default**: [`["dockerfile", "containerfile"]`](./src/embedded/dockerfile/options.ts)
+- **Description**: Block comments that identify embedded Dockerfile in template literals. Requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin.
+
+##### `embeddedDockerfileTags`
+
+- **Type**: `string[]`
+- **Default**: [`["dockerfile", "containerfile"]`](./src/embedded/dockerfile/options.ts)
+- **Description**: Tags that identify embedded Dockerfile in template literals. Requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin.
+
+Formatting embedded Dockerfile requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+Dockerfile and Shell share `prettier-plugin-sh`; the Dockerfile integration selects its `dockerfile` parser.
+
 #### ES (ECMAScript/JavaScript)
 
 ##### `embeddedEsComments`
@@ -250,21 +301,53 @@ Embedded ECMAScript and JavaScript use the parsers and printers included with Pr
 
 If you want to specify different parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
+#### Gherkin
+
+##### `embeddedGherkinComments`
+
+- **Type**: `string[]`
+- **Default**: [`["gherkin", "feature"]`](./src/embedded/gherkin/options.ts)
+- **Description**: Block comments that identify embedded Gherkin in template literals. Requires the [`prettier-plugin-gherkin`](https://github.com/mapado/prettier-plugin-gherkin#readme) plugin.
+
+##### `embeddedGherkinTags`
+
+- **Type**: `string[]`
+- **Default**: [`["gherkin", "feature"]`](./src/embedded/gherkin/options.ts)
+- **Description**: Tags that identify embedded Gherkin in template literals. Requires the [`prettier-plugin-gherkin`](https://github.com/mapado/prettier-plugin-gherkin#readme) plugin.
+
+Formatting embedded Gherkin requires the [`prettier-plugin-gherkin`](https://github.com/mapado/prettier-plugin-gherkin#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
 #### GLSL
 
 ##### `embeddedGlslComments`
 
 - **Type**: `string[]`
 - **Default**: [`["glsl", "shader"]`](./src/embedded/glsl/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded GLSL language. This option requires the `prettier-plugin-glsl` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded GLSL language. This option requires the [`prettier-plugin-glsl`](https://github.com/NaridaL/glsl-language-toolkit/tree/main/packages/prettier-plugin-glsl#readme) plugin.
 
 ##### `embeddedGlslTags`
 
 - **Type**: `string[]`
 - **Default**: [`["glsl", "shader"]`](./src/embedded/glsl/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded GLSL language. This option requires the `prettier-plugin-glsl` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded GLSL language. This option requires the [`prettier-plugin-glsl`](https://github.com/NaridaL/glsl-language-toolkit/tree/main/packages/prettier-plugin-glsl#readme) plugin.
+
+Formatting embedded GLSL language requires the [`prettier-plugin-glsl`](https://github.com/NaridaL/glsl-language-toolkit/tree/main/packages/prettier-plugin-glsl#readme) plugin to be loaded as well.
+
+#### Go Template
+
+##### `embeddedGoTemplateComments`
 
-Formatting embedded GLSL language requires the [`prettier-plugin-glsl`](https://github.com/NaridaL/glsl-language-toolkit/tree/main/packages/prettier-plugin-glsl) plugin to be loaded as well.
+- **Type**: `string[]`
+- **Default**: [`["goTemplate", "gotmpl"]`](./src/embedded/go-template/options.ts)
+- **Description**: Block comments that identify embedded Go Template in template literals. Requires the [`@htnabe/prettier-plugin-go-template`](https://github.com/htnabe/prettier-plugin-go-template#readme) plugin.
+
+##### `embeddedGoTemplateTags`
+
+- **Type**: `string[]`
+- **Default**: [`["goTemplate", "gotmpl"]`](./src/embedded/go-template/options.ts)
+- **Description**: Tags that identify embedded Go Template in template literals. Requires the [`@htnabe/prettier-plugin-go-template`](https://github.com/htnabe/prettier-plugin-go-template#readme) plugin.
+
+Formatting embedded Go Template requires the [`@htnabe/prettier-plugin-go-template`](https://github.com/htnabe/prettier-plugin-go-template#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
 #### GraphQL
 
@@ -284,6 +367,22 @@ Embedded GraphQL uses the parsers and printers included with Prettier.
 
 This can override the native formatting behavior for embedded GraphQL language. If you want to keep the native behavior, set `embeddedGraphqlComments` or `embeddedGraphqlTags` to `[]` or other values.
 
+#### Handlebars
+
+##### `embeddedHandlebarsComments`
+
+- **Type**: `string[]`
+- **Default**: [`["handlebars", "hbs"]`](./src/embedded/handlebars/options.ts)
+- **Description**: Block comments that identify embedded Handlebars in template literals. Requires the [`@poliklot/prettier-plugin-handlebars`](https://github.com/Poliklot/prettier-plugin-handlebars#readme) plugin.
+
+##### `embeddedHandlebarsTags`
+
+- **Type**: `string[]`
+- **Default**: [`["handlebars", "hbs"]`](./src/embedded/handlebars/options.ts)
+- **Description**: Tags that identify embedded Handlebars in template literals. Requires the [`@poliklot/prettier-plugin-handlebars`](https://github.com/Poliklot/prettier-plugin-handlebars#readme) plugin.
+
+Formatting embedded Handlebars requires the [`@poliklot/prettier-plugin-handlebars`](https://github.com/Poliklot/prettier-plugin-handlebars#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
 #### HTML
 
 ##### `embeddedHtmlComments`
@@ -310,21 +409,37 @@ This can override the native formatting behavior for embedded HTML language. If
 
 If you want to specify different parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
+#### Hugo
+
+##### `embeddedHugoComments`
+
+- **Type**: `string[]`
+- **Default**: [`["hugo", "hugoPost"]`](./src/embedded/hugo/options.ts)
+- **Description**: Block comments that identify embedded Hugo in template literals. Requires the [`@htnabe/prettier-plugin-hugo-post`](https://github.com/htnabe/prettier-plugin-hugo-post#readme) plugin.
+
+##### `embeddedHugoTags`
+
+- **Type**: `string[]`
+- **Default**: [`["hugo", "hugoPost"]`](./src/embedded/hugo/options.ts)
+- **Description**: Tags that identify embedded Hugo in template literals. Requires the [`@htnabe/prettier-plugin-hugo-post`](https://github.com/htnabe/prettier-plugin-hugo-post#readme) plugin.
+
+Formatting embedded Hugo requires the [`@htnabe/prettier-plugin-hugo-post`](https://github.com/htnabe/prettier-plugin-hugo-post#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
 #### INI
 
 ##### `embeddedIniComments`
 
 - **Type**: `string[]`
 - **Default**: [`["ini", "cfg", "pro"]`](./src/embedded/ini/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded INI language. This option requires the `prettier-plugin-ini` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded INI language. This option requires the [`prettier-plugin-ini`](https://github.com/kddnewton/prettier-plugin-ini#readme) plugin.
 
 ##### `embeddedIniTags`
 
 - **Type**: `string[]`
 - **Default**: [`["ini", "cfg", "pro"]`](./src/embedded/ini/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded INI language. This option requires the `prettier-plugin-ini` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded INI language. This option requires the [`prettier-plugin-ini`](https://github.com/kddnewton/prettier-plugin-ini#readme) plugin.
 
-Formatting embedded INI language requires the [`prettier-plugin-ini`](https://github.com/kddnewton/prettier-plugin-ini) plugin to be loaded as well. And [options](https://github.com/kddnewton/prettier-plugin-ini#configuration) supported by `prettier-plugin-ini` can therefore be used to further control the formatting behavior.
+Formatting embedded INI language requires the [`prettier-plugin-ini`](https://github.com/kddnewton/prettier-plugin-ini#readme) plugin to be loaded as well. And [options](https://github.com/kddnewton/prettier-plugin-ini#configuration) supported by `prettier-plugin-ini` can therefore be used to further control the formatting behavior.
 
 #### Java
 
@@ -332,15 +447,33 @@ Formatting embedded INI language requires the [`prettier-plugin-ini`](https://gi
 
 - **Type**: `string[]`
 - **Default**: [`["java"]`](./src/embedded/java/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Java language. This option requires the `prettier-plugin-java` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Java language. This option requires the [`prettier-plugin-java`](https://github.com/jhipster/prettier-java#readme) plugin.
 
 ##### `embeddedJavaTags`
 
 - **Type**: `string[]`
 - **Default**: [`["java"]`](./src/embedded/java/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Java language. This option requires the `prettier-plugin-java` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Java language. This option requires the [`prettier-plugin-java`](https://github.com/jhipster/prettier-java#readme) plugin.
+
+Formatting embedded Java language requires the [`prettier-plugin-java`](https://github.com/jhipster/prettier-java#readme) plugin to be loaded as well. And [options](https://github.com/jhipster/prettier-java/blob/main/docs/advanced_usage.md#configuration) supported by `prettier-plugin-java` can therefore be used to further control the formatting behavior.
+
+#### Jinja
+
+##### `embeddedJinjaComments`
+
+- **Type**: `string[]`
+- **Default**: [`["jinja", "jinja2", "j2"]`](./src/embedded/jinja/options.ts)
+- **Description**: Block comments that identify embedded Jinja in template literals. Requires the [`prettier-plugin-jinja-template`](https://github.com/davidodenwald/prettier-plugin-jinja-template#readme) plugin.
+
+##### `embeddedJinjaTags`
 
-Formatting embedded Java language requires the [`prettier-plugin-java`](https://github.com/jhipster/prettier-java/tree/main/packages/prettier-plugin-java) plugin to be loaded as well. And [options](https://github.com/jhipster/prettier-java/tree/main/packages/prettier-plugin-java#options) supported by `prettier-plugin-java` can therefore be used to further control the formatting behavior.
+- **Type**: `string[]`
+- **Default**: [`["jinja", "jinja2", "j2"]`](./src/embedded/jinja/options.ts)
+- **Description**: Tags that identify embedded Jinja in template literals. Requires the [`prettier-plugin-jinja-template`](https://github.com/davidodenwald/prettier-plugin-jinja-template#readme) plugin.
+
+Formatting embedded Jinja requires the [`prettier-plugin-jinja-template`](https://github.com/davidodenwald/prettier-plugin-jinja-template#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+The formatter uses the source block's line breaks to choose its layout. Write block bodies across lines for consistent formatting when their content wraps.
 
 #### JSON
 
@@ -372,15 +505,31 @@ If you want to specify different parsers for different comments or tags, check [
 
 - **Type**: `string[]`
 - **Default**: [`["jsonata"]`](./src/embedded/jsonata/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded JSONata language. This option requires the `@stedi/prettier-plugin-jsonata` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded JSONata language. This option requires the [`@stedi/prettier-plugin-jsonata`](https://www.npmjs.com/package/@stedi/prettier-plugin-jsonata) plugin.
 
 ##### `embeddedJsonataTags`
 
 - **Type**: `string[]`
 - **Default**: [`["jsonata"]`](./src/embedded/jsonata/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded JSONata language. This option requires the `@stedi/prettier-plugin-jsonata` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded JSONata language. This option requires the [`@stedi/prettier-plugin-jsonata`](https://www.npmjs.com/package/@stedi/prettier-plugin-jsonata) plugin.
+
+Formatting embedded JSONata language requires the [`@stedi/prettier-plugin-jsonata`](https://www.npmjs.com/package/@stedi/prettier-plugin-jsonata) plugin to be loaded as well.
+
+#### JTE
+
+##### `embeddedJteComments`
+
+- **Type**: `string[]`
+- **Default**: [`["jte"]`](./src/embedded/jte/options.ts)
+- **Description**: Block comments that identify embedded JTE in template literals. Requires the [`prettier-plugin-jte`](https://github.com/sgruendel/prettier-plugin-jte#readme) plugin.
+
+##### `embeddedJteTags`
 
-Formatting embedded JSONata language requires the [`@stedi/prettier-plugin-jsonata`](https://github.com/Stedi/prettier-plugin-jsonata) plugin to be loaded as well.
+- **Type**: `string[]`
+- **Default**: [`["jte"]`](./src/embedded/jte/options.ts)
+- **Description**: Tags that identify embedded JTE in template literals. Requires the [`prettier-plugin-jte`](https://github.com/sgruendel/prettier-plugin-jte#readme) plugin.
+
+Formatting embedded JTE requires the [`prettier-plugin-jte`](https://github.com/sgruendel/prettier-plugin-jte#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
 #### LaTeX
 
@@ -388,15 +537,31 @@ Formatting embedded JSONata language requires the [`@stedi/prettier-plugin-jsona
 
 - **Type**: `string[]`
 - **Default**: [`["latex", "tex", "aux", "cls", "bbl", "bib", "toc", "sty"]`](./src/embedded/latex/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded LaTeX language. This option requires the `prettier-plugin-latex` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded LaTeX language. This option requires the [`prettier-plugin-latex`](https://github.com/siefkenj/prettier-plugin-latex#readme) plugin.
 
 ##### `embeddedLatexTags`
 
 - **Type**: `string[]`
 - **Default**: [`["latex", "tex", "aux", "cls", "bbl", "bib", "toc", "sty"]`](./src/embedded/latex/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded LaTeX language. This option requires the `prettier-plugin-latex` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded LaTeX language. This option requires the [`prettier-plugin-latex`](https://github.com/siefkenj/prettier-plugin-latex#readme) plugin.
+
+Formatting embedded LaTeX language requires the [`prettier-plugin-latex`](https://github.com/siefkenj/prettier-plugin-latex#readme) plugin to be loaded as well.
+
+#### Liquid
+
+##### `embeddedLiquidComments`
 
-Formatting embedded LaTeX language requires the [`prettier-plugin-latex`](https://github.com/siefkenj/prettier-plugin-latex) plugin to be loaded as well.
+- **Type**: `string[]`
+- **Default**: [`["liquid"]`](./src/embedded/liquid/options.ts)
+- **Description**: Block comments that identify embedded Liquid in template literals. Requires the [`@shopify/prettier-plugin-liquid`](https://github.com/Shopify/theme-tools/tree/main/packages/prettier-plugin-liquid#readme) plugin.
+
+##### `embeddedLiquidTags`
+
+- **Type**: `string[]`
+- **Default**: [`["liquid"]`](./src/embedded/liquid/options.ts)
+- **Description**: Tags that identify embedded Liquid in template literals. Requires the [`@shopify/prettier-plugin-liquid`](https://github.com/Shopify/theme-tools/tree/main/packages/prettier-plugin-liquid#readme) plugin.
+
+Formatting embedded Liquid requires the [`@shopify/prettier-plugin-liquid`](https://github.com/Shopify/theme-tools/tree/main/packages/prettier-plugin-liquid#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
 #### Markdown
 
@@ -426,21 +591,85 @@ If you want to specify different parsers for different comments or tags, check [
 
 The `remark` parser is [an alias of the `markdown` parser](https://github.com/prettier/prettier/blob/ed23dacc9e655c3876971b30859497b17ff2cf9f/src/language-markdown/parser-markdown.js#L57).
 
+#### Marko
+
+##### `embeddedMarkoComments`
+
+- **Type**: `string[]`
+- **Default**: [`["marko"]`](./src/embedded/marko/options.ts)
+- **Description**: Block comments that identify embedded Marko in template literals. Requires the [`prettier-plugin-marko`](https://github.com/marko-js/prettier#readme) plugin.
+
+##### `embeddedMarkoTags`
+
+- **Type**: `string[]`
+- **Default**: [`["marko"]`](./src/embedded/marko/options.ts)
+- **Description**: Tags that identify embedded Marko in template literals. Requires the [`prettier-plugin-marko`](https://github.com/marko-js/prettier#readme) plugin.
+
+Formatting embedded Marko requires the [`prettier-plugin-marko`](https://github.com/marko-js/prettier#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+#### Motoko
+
+##### `embeddedMotokoComments`
+
+- **Type**: `string[]`
+- **Default**: [`["motoko", "mo"]`](./src/embedded/motoko/options.ts)
+- **Description**: Block comments that identify embedded Motoko in template literals. Requires the [`prettier-plugin-motoko`](https://github.com/caffeinelabs/prettier-plugin-motoko#readme) plugin.
+
+##### `embeddedMotokoTags`
+
+- **Type**: `string[]`
+- **Default**: [`["motoko", "mo"]`](./src/embedded/motoko/options.ts)
+- **Description**: Tags that identify embedded Motoko in template literals. Requires the [`prettier-plugin-motoko`](https://github.com/caffeinelabs/prettier-plugin-motoko#readme) plugin.
+
+Formatting embedded Motoko requires the [`prettier-plugin-motoko`](https://github.com/caffeinelabs/prettier-plugin-motoko#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+#### Mustache
+
+##### `embeddedMustacheComments`
+
+- **Type**: `string[]`
+- **Default**: [`["mustache"]`](./src/embedded/mustache/options.ts)
+- **Description**: Block comments that identify embedded Mustache in template literals. Requires the [`prettier-plugin-mustache`](https://github.com/Poliklot/prettier-plugin-mustache#readme) plugin.
+
+##### `embeddedMustacheTags`
+
+- **Type**: `string[]`
+- **Default**: [`["mustache"]`](./src/embedded/mustache/options.ts)
+- **Description**: Tags that identify embedded Mustache in template literals. Requires the [`prettier-plugin-mustache`](https://github.com/Poliklot/prettier-plugin-mustache#readme) plugin.
+
+Formatting embedded Mustache requires the [`prettier-plugin-mustache`](https://github.com/Poliklot/prettier-plugin-mustache#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
 #### NGINX
 
 ##### `embeddedNginxComments`
 
 - **Type**: `string[]`
 - **Default**: [`["nginx"]`](./src/embedded/nginx/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded NGINX language. This option requires the `prettier-plugin-nginx` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded NGINX language. This option requires the [`prettier-plugin-nginx`](https://github.com/jxddk/prettier-plugin-nginx#readme) plugin.
 
 ##### `embeddedNginxTags`
 
 - **Type**: `string[]`
 - **Default**: [`["nginx"]`](./src/embedded/nginx/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded NGINX language. This option requires the `prettier-plugin-nginx` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded NGINX language. This option requires the [`prettier-plugin-nginx`](https://github.com/jxddk/prettier-plugin-nginx#readme) plugin.
+
+Formatting embedded NGINX language requires the [`prettier-plugin-nginx`](https://github.com/jxddk/prettier-plugin-nginx#readme) plugin to be loaded as well. And [options](https://github.com/jxddk/prettier-plugin-nginx?tab=readme-ov-file#configuration) supported by `prettier-plugin-nginx` can therefore be used to further control the formatting behavior.
+
+#### Nunjucks
 
-Formatting embedded NGINX language requires the [`prettier-plugin-nginx`](https://github.com/jxddk/prettier-plugin-nginx) plugin to be loaded as well. And [options](https://github.com/jxddk/prettier-plugin-nginx?tab=readme-ov-file#configuration) supported by `prettier-plugin-nginx` can therefore be used to further control the formatting behavior.
+##### `embeddedNunjucksComments`
+
+- **Type**: `string[]`
+- **Default**: [`["nunjucks", "njk"]`](./src/embedded/nunjucks/options.ts)
+- **Description**: Block comments that identify embedded Nunjucks in template literals. Requires the [`prettier-plugin-nunjucks`](https://github.com/Poliklot/prettier-plugin-nunjucks#readme) plugin.
+
+##### `embeddedNunjucksTags`
+
+- **Type**: `string[]`
+- **Default**: [`["nunjucks", "njk"]`](./src/embedded/nunjucks/options.ts)
+- **Description**: Tags that identify embedded Nunjucks in template literals. Requires the [`prettier-plugin-nunjucks`](https://github.com/Poliklot/prettier-plugin-nunjucks#readme) plugin.
+
+Formatting embedded Nunjucks requires the [`prettier-plugin-nunjucks`](https://github.com/Poliklot/prettier-plugin-nunjucks#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
 #### Pegjs
 
@@ -448,15 +677,15 @@ Formatting embedded NGINX language requires the [`prettier-plugin-nginx`](https:
 
 - **Type**: `string[]`
 - **Default**: [`["pegjs", "peggy", "peg"]`](./src/embedded/pegjs/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Pegjs language. This option requires the `prettier-plugin-pegjs` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Pegjs language. This option requires the [`prettier-plugin-pegjs`](https://github.com/siefkenj/prettier-plugin-pegjs#readme) plugin.
 
 ##### `embeddedPegjsTags`
 
 - **Type**: `string[]`
 - **Default**: [`["pegjs", "peggy", "peg"]`](./src/embedded/pegjs/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Pegjs language. This option requires the `prettier-plugin-pegjs` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Pegjs language. This option requires the [`prettier-plugin-pegjs`](https://github.com/siefkenj/prettier-plugin-pegjs#readme) plugin.
 
-Formatting embedded Pegjs language requires the [`prettier-plugin-pegjs`](https://github.com/siefkenj/prettier-plugin-pegjs) plugin to be loaded as well. And [options](https://github.com/siefkenj/prettier-plugin-pegjs?tab=readme-ov-file#options) supported by `prettier-plugin-pegjs` can therefore be used to further control the formatting behavior.
+Formatting embedded Pegjs language requires the [`prettier-plugin-pegjs`](https://github.com/siefkenj/prettier-plugin-pegjs#readme) plugin to be loaded as well. And [options](https://github.com/siefkenj/prettier-plugin-pegjs?tab=readme-ov-file#options) supported by `prettier-plugin-pegjs` can therefore be used to further control the formatting behavior.
 
 Note that `prettier-plugin-pegjs` supports different parsers for the action blocks and they are specified by the [`actionParser` option](https://github.com/siefkenj/prettier-plugin-pegjs?tab=readme-ov-file#options). If you want to specify different action parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
@@ -466,15 +695,31 @@ Note that `prettier-plugin-pegjs` supports different parsers for the action bloc
 
 - **Type**: `string[]`
 - **Default**: [`["php", "php5"]`](./src/embedded/php/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded PHP language. This option requires the `@prettier/plugin-php` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded PHP language. This option requires the [`@prettier/plugin-php`](https://github.com/prettier/plugin-php#readme) plugin.
 
 ##### `embeddedPhpTags`
 
 - **Type**: `string[]`
 - **Default**: [`["php", "php5"]`](./src/embedded/php/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded PHP language. This option requires the `@prettier/plugin-php` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded PHP language. This option requires the [`@prettier/plugin-php`](https://github.com/prettier/plugin-php#readme) plugin.
+
+Formatting embedded PHP language requires the [`@prettier/plugin-php`](https://github.com/prettier/plugin-php#readme) plugin to be loaded as well. And [options](https://github.com/prettier/plugin-php#configuration) supported by `@prettier/plugin-php` can therefore be used to further control the formatting behavior.
+
+#### PowerShell
+
+##### `embeddedPowerShellComments`
 
-Formatting embedded PHP language requires the [`@prettier/plugin-php`](https://github.com/prettier/plugin-php) plugin to be loaded as well. And [options](https://github.com/prettier/plugin-php#configuration) supported by `@prettier/plugin-php` can therefore be used to further control the formatting behavior.
+- **Type**: `string[]`
+- **Default**: [`["powershell", "ps1"]`](./src/embedded/powershell/options.ts)
+- **Description**: Block comments that identify embedded PowerShell in template literals. Requires the [`prettier-plugin-powershell`](https://github.com/Nick2bad4u/Prettier-Plugin-Powershell#readme) plugin.
+
+##### `embeddedPowerShellTags`
+
+- **Type**: `string[]`
+- **Default**: [`["powershell", "ps1"]`](./src/embedded/powershell/options.ts)
+- **Description**: Tags that identify embedded PowerShell in template literals. Requires the [`prettier-plugin-powershell`](https://github.com/Nick2bad4u/Prettier-Plugin-Powershell#readme) plugin.
+
+Formatting embedded PowerShell requires the [`prettier-plugin-powershell`](https://github.com/Nick2bad4u/Prettier-Plugin-Powershell#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
 #### Prisma
 
@@ -482,15 +727,15 @@ Formatting embedded PHP language requires the [`@prettier/plugin-php`](https://g
 
 - **Type**: `string[]`
 - **Default**: [`["prisma"]`](./src/embedded/prisma/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Prisma language. This option requires the `prettier-plugin-prisma` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Prisma language. This option requires the [`prettier-plugin-prisma`](https://github.com/avocadowastaken/prettier-plugin-prisma#readme) plugin.
 
 ##### `embeddedPrismaTags`
 
 - **Type**: `string[]`
 - **Default**: [`["prisma"]`](./src/embedded/prisma/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Prisma language. This option requires the `prettier-plugin-prisma` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Prisma language. This option requires the [`prettier-plugin-prisma`](https://github.com/avocadowastaken/prettier-plugin-prisma#readme) plugin.
 
-Formatting embedded Prisma language requires the [`prettier-plugin-prisma`](https://github.com/avocadowastaken/prettier-plugin-prisma) plugin to be loaded as well.
+Formatting embedded Prisma language requires the [`prettier-plugin-prisma`](https://github.com/avocadowastaken/prettier-plugin-prisma#readme) plugin to be loaded as well.
 
 #### Properties
 
@@ -498,15 +743,15 @@ Formatting embedded Prisma language requires the [`prettier-plugin-prisma`](http
 
 - **Type**: `string[]`
 - **Default**: [`["properties"]`](./src/embedded/properties/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Properties language. This option requires the `prettier-plugin-properties` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Properties language. This option requires the [`prettier-plugin-properties`](https://github.com/eemeli/prettier-plugin-properties#readme) plugin.
 
 ##### `embeddedPropertiesTags`
 
 - **Type**: `string[]`
 - **Default**: [`["properties"]`](./src/embedded/properties/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Properties language. This option requires the `prettier-plugin-properties` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Properties language. This option requires the [`prettier-plugin-properties`](https://github.com/eemeli/prettier-plugin-properties#readme) plugin.
 
-Formatting embedded Properties language requires the [`prettier-plugin-properties`](https://github.com/eemeli/prettier-plugin-properties) plugin to be loaded as well. And [options](https://github.com/eemeli/prettier-plugin-properties#configuration) supported by `prettier-plugin-properties` can therefore be used to further control the formatting behavior.
+Formatting embedded Properties language requires the [`prettier-plugin-properties`](https://github.com/eemeli/prettier-plugin-properties#readme) plugin to be loaded as well. And [options](https://github.com/eemeli/prettier-plugin-properties#configuration) supported by `prettier-plugin-properties` can therefore be used to further control the formatting behavior.
 
 #### Pug
 
@@ -514,15 +759,15 @@ Formatting embedded Properties language requires the [`prettier-plugin-propertie
 
 - **Type**: `string[]`
 - **Default**: [`["pug", "jade"]`](./src/embedded/pug/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Pug language. This option requires the `@prettier/plugin-pug` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Pug language. This option requires the [`@prettier/plugin-pug`](https://github.com/prettier/plugin-pug#readme) plugin.
 
 ##### `embeddedPugTags`
 
 - **Type**: `string[]`
 - **Default**: [`["pug", "jade"]`](./src/embedded/pug/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Pug language. This option requires the `@prettier/plugin-pug` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Pug language. This option requires the [`@prettier/plugin-pug`](https://github.com/prettier/plugin-pug#readme) plugin.
 
-Formatting embedded Pug language requires the [`@prettier/plugin-pug`](https://github.com/prettier/plugin-pug) plugin to be loaded as well. And [options](https://github.com/prettier/plugin-pug?tab=readme-ov-file#configuration) supported by `@prettier/plugin-pug` can therefore be used to further control the formatting behavior.
+Formatting embedded Pug language requires the [`@prettier/plugin-pug`](https://github.com/prettier/plugin-pug#readme) plugin to be loaded as well. And [options](https://github.com/prettier/plugin-pug?tab=readme-ov-file#configuration) supported by `@prettier/plugin-pug` can therefore be used to further control the formatting behavior.
 
 #### Ruby
 
@@ -530,21 +775,21 @@ Formatting embedded Pug language requires the [`@prettier/plugin-pug`](https://g
 
 - **Type**: `string[]`
 - **Default**: [`["ruby"]`](./src/embedded/ruby/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Ruby language. This option requires the `@prettier/plugin-ruby` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Ruby language. This option requires the [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby#readme) plugin.
 
 ##### `embeddedRubyTags`
 
 - **Type**: `string[]`
 - **Default**: [`["ruby"]`](./src/embedded/ruby/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Ruby language. This option requires the `@prettier/plugin-ruby` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Ruby language. This option requires the [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby#readme) plugin.
 
 ##### `embeddedRubyParser`
 
 - **Type**: [`"ruby" | "rbs" | "haml"`](./src/embedded/ruby/options.ts)
 - **Default**: [`"ruby"`](./src/embedded/ruby/options.ts)
-- **Description**: The parser used to parse the embedded Ruby language. This option requires the `@prettier/plugin-ruby` plugin.
+- **Description**: The parser used to parse the embedded Ruby language. This option requires the [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby#readme) plugin.
 
-Formatting embedded Ruby language requires the [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby) to be loaded and [its dependencies to be installed](https://github.com/prettier/plugin-ruby#getting-started) as well. And [options](https://github.com/prettier/plugin-ruby#configuration) supported by `@prettier/plugin-ruby` can therefore be used to further control the formatting behavior.
+Formatting embedded Ruby language requires the [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby#readme) to be loaded and [its dependencies to be installed](https://github.com/prettier/plugin-ruby#getting-started) as well. And [options](https://github.com/prettier/plugin-ruby#configuration) supported by `@prettier/plugin-ruby` can therefore be used to further control the formatting behavior.
 
 If you want to specify different parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
@@ -554,37 +799,61 @@ If you want to specify different parsers for different comments or tags, check [
 
 - **Type**: `string[]`
 - **Default**: [`["sh"]`](./src/embedded/sh/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded Shell language. This option requires the `prettier-plugin-sh` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded Shell language. This option requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin.
 
 ##### `embeddedShTags`
 
 - **Type**: `string[]`
 - **Default**: [`["sh"]`](./src/embedded/sh/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded Shell language. This option requires the `prettier-plugin-sh` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded Shell language. This option requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin.
 
 Formatting embedded Shell language requires the [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) plugin to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sh#parser-options) supported by `prettier-plugin-sh` can therefore be used to further control the formatting behavior.
 
 Note that `prettier-plugin-sh` supports different variants of shell syntaxes and they are specified by the [`variant` option](https://github.com/un-ts/prettier/tree/master/packages/sh#parser-options). If you want to specify different variants for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
+#### Solidity
+
+##### `embeddedSolidityComments`
+
+- **Type**: `string[]`
+- **Default**: [`["solidity", "sol"]`](./src/embedded/solidity/options.ts)
+- **Description**: Block comments that identify embedded Solidity in template literals. Requires the [`prettier-plugin-solidity`](https://github.com/prettier-solidity/prettier-plugin-solidity#readme) plugin.
+
+##### `embeddedSolidityTags`
+
+- **Type**: `string[]`
+- **Default**: [`["solidity", "sol"]`](./src/embedded/solidity/options.ts)
+- **Description**: Tags that identify embedded Solidity in template literals. Requires the [`prettier-plugin-solidity`](https://github.com/prettier-solidity/prettier-plugin-solidity#readme) plugin.
+
+##### `embeddedSolidityParser`
+
+- **Type**: [`"slang" | "antlr" | "solidity-parse"`](./src/embedded/solidity/options.ts)
+- **Default**: [`"slang"`](./src/embedded/solidity/options.ts)
+- **Description**: The parser used to format embedded Solidity.
+
+Formatting embedded Solidity requires the [`prettier-plugin-solidity`](https://github.com/prettier-solidity/prettier-plugin-solidity#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+Choose `"slang"` or `"antlr"` with current formatter versions. Formatter versions exposing `"solidity-parse"` use `embeddedSolidityParser: "solidity-parse"`.
+
 #### SQL
 
 ##### `embeddedSqlComments`
 
 - **Type**: `string[]`
 - **Default**: [`["sql"]`](./src/embedded/sql/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded SQL language. This option requires the `prettier-plugin-sql` plugin or the `prettier-plugin-sql-cst` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded SQL language. This option requires the [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) plugin or the [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst#readme) plugin.
 
 ##### `embeddedSqlTags`
 
 - **Type**: `string[]`
 - **Default**: [`["sql"]`](./src/embedded/sql/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded SQL language. This option requires the `prettier-plugin-sql` plugin or the `prettier-plugin-sql-cst` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded SQL language. This option requires the [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) plugin or the [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst#readme) plugin.
 
 ##### `embeddedSqlPlugin`
 
 - **Type**: [`"prettier-plugin-sql" | "prettier-plugin-sql-cst"`](./src/embedded/sql/options.ts)
 - **Default**: [`"prettier-plugin-sql"`](./src/embedded/sql/options.ts)
-- **Description**: The plugin used to format the embedded SQL language. This option requires the `prettier-plugin-sql` plugin or the `prettier-plugin-sql-cst` plugin.
+- **Description**: The plugin used to format the embedded SQL language. This option requires the [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) plugin or the [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst#readme) plugin.
 
 ##### `embeddedSqlParser`
 
@@ -592,23 +861,41 @@ Note that `prettier-plugin-sh` supports different variants of shell syntaxes and
 - **Default**: [`"sqlite"`](./src/embedded/sql/options.ts)
 - **Description**: Specify the embedded SQL language parser. This option is only needed with the `prettier-plugin-sql-cst` plugin.
 
-Formatting embedded SQL language requires the [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) plugin or the [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst) plugin to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options) supported by `prettier-plugin-sql`, or [options](https://github.com/nene/prettier-plugin-sql-cst?tab=readme-ov-file#configuration) supported by `prettier-plugin-sql-cst` can therefore be used to further control the formatting behavior.
+Formatting embedded SQL language requires the [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) plugin or the [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst#readme) plugin to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options) supported by `prettier-plugin-sql`, or [options](https://github.com/nene/prettier-plugin-sql-cst?tab=readme-ov-file#configuration) supported by `prettier-plugin-sql-cst` can therefore be used to further control the formatting behavior.
 
 Note that `prettier-plugin-sql` supports many different SQL dialects which are specified by the [`language`, `database` or `dialect` option](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options). And `prettier-plugin-sql-cst` also supports various parsers as shown above. If you want to specify different dialects or parsers for different comments or tags, check [`embeddedOverrides`](#embeddedoverrides-1).
 
+#### Svelte
+
+##### `embeddedSvelteComments`
+
+- **Type**: `string[]`
+- **Default**: [`["svelte"]`](./src/embedded/svelte/options.ts)
+- **Description**: Block comments that identify embedded Svelte in template literals. Requires the [`prettier-plugin-svelte`](https://github.com/sveltejs/prettier-plugin-svelte#readme) plugin.
+
+##### `embeddedSvelteTags`
+
+- **Type**: `string[]`
+- **Default**: [`["svelte"]`](./src/embedded/svelte/options.ts)
+- **Description**: Tags that identify embedded Svelte in template literals. Requires the [`prettier-plugin-svelte`](https://github.com/sveltejs/prettier-plugin-svelte#readme) plugin.
+
+Formatting embedded Svelte requires the [`prettier-plugin-svelte`](https://github.com/sveltejs/prettier-plugin-svelte#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
+
+Supply the `svelte` compiler alongside the formatter plugin, using versions compatible with the project's Svelte version.
+
 #### TOML
 
 ##### `embeddedTomlComments`
 
 - **Type**: `string[]`
 - **Default**: [`["toml"]`](./src/embedded/toml/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded TOML language. This option requires the `prettier-plugin-toml` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded TOML language. This option requires the [`prettier-plugin-toml`](https://github.com/un-ts/prettier/tree/master/packages/toml#readme) plugin.
 
 ##### `embeddedTomlTags`
 
 - **Type**: `string[]`
 - **Default**: [`["toml"]`](./src/embedded/toml/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded TOML language. This option requires the `prettier-plugin-toml` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded TOML language. This option requires the [`prettier-plugin-toml`](https://github.com/un-ts/prettier/tree/master/packages/toml#readme) plugin.
 
 Formatting embedded TOML language requires the [`prettier-plugin-toml`](https://github.com/un-ts/prettier/tree/master/packages/toml#readme) plugin to be loaded as well. And [options](https://github.com/un-ts/prettier/blob/master/packages/toml/src/options.ts) supported by `prettier-plugin-toml` can therefore be used to further control the formatting behavior.
 
@@ -642,15 +929,39 @@ If you want to specify different parsers for different comments or tags, check [
 
 - **Type**: `string[]`
 - **Default**: [`["xml", "opml", "rss", "svg"]`](./src/embedded/xml/options.ts)
-- **Description**: Block comments that make their subsequent template literals be identified as embedded XML language. This option requires the `@prettier/plugin-xml` plugin.
+- **Description**: Block comments that make their subsequent template literals be identified as embedded XML language. This option requires the [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml#readme) plugin.
 
 ##### `embeddedXmlTags`
 
 - **Type**: `string[]`
 - **Default**: [`["xml", "opml", "rss", "svg"]`](./src/embedded/xml/options.ts)
-- **Description**: Tags that make their subsequent template literals be identified as embedded XML language. This option requires the `@prettier/plugin-xml` plugin.
+- **Description**: Tags that make their subsequent template literals be identified as embedded XML language. This option requires the [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml#readme) plugin.
+
+Embedded XML uses the parser provided by [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml#readme), which must be loaded when XML formatting is enabled. Its [options](https://github.com/prettier/plugin-xml#configuration) control the XML formatting behavior.
+
+#### XQuery
+
+##### `embeddedXQueryComments`
+
+- **Type**: `string[]`
+- **Default**: [`["xquery", "xq"]`](./src/embedded/xquery/options.ts)
+- **Description**: Block comments that identify embedded XQuery in template literals. Requires the [`prettier-plugin-xquery`](https://github.com/DrRataplan/prettier-plugin-xquery#readme) plugin.
+
+##### `embeddedXQueryTags`
+
+- **Type**: `string[]`
+- **Default**: [`["xquery", "xq"]`](./src/embedded/xquery/options.ts)
+- **Description**: Tags that identify embedded XQuery in template literals. Requires the [`prettier-plugin-xquery`](https://github.com/DrRataplan/prettier-plugin-xquery#readme) plugin.
+
+##### `embeddedXQueryParser`
+
+- **Type**: [`"xquery" | "xquery4"`](./src/embedded/xquery/options.ts)
+- **Default**: [`"xquery"`](./src/embedded/xquery/options.ts)
+- **Description**: The parser used to format embedded XQuery.
+
+Formatting embedded XQuery requires the [`prettier-plugin-xquery`](https://github.com/DrRataplan/prettier-plugin-xquery#readme) plugin to be installed and loaded. Its options control the embedded formatting behavior.
 
-Embedded XML uses the parser provided by [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml), which must be loaded when XML formatting is enabled. Its [options](https://github.com/prettier/plugin-xml#configuration) control the XML formatting behavior.
+The default `"xquery"` parser formats XQuery 3.1. Select `"xquery4"` for the XQuery 4 syntax supported by the installed formatter version.
 
 #### YAML
 
@@ -698,7 +1009,7 @@ This option is provided for users to override certain options based on comments
 
 TypeScript override files (`.ts`, `.mts` and `.cts`) are loaded with the active runtime's `import()`. Node.js with [native type stripping](https://nodejs.org/api/typescript.html) enabled can load erasable TypeScript, and Bun provides native TypeScript loading. The runtime determines module semantics: `.mts` uses ES modules, `.cts` uses CommonJS, and `.ts` follows the package's module type.
 
-Consumers can enable a compatible loader through Node.js startup options, such as `node --import tsx node_modules/prettier/bin/prettier.cjs . --write`. Override files are evaluated in workers, which inherit the runtime's startup preloads. Enable synchronous module hooks through a `--import` or `--require` preload so they are available in those workers. When the runtime reports unsupported module loading or TypeScript transformation, the plugin can use the consumer project's optional [`tsx`](https://github.com/privatenumber/tsx) 4.19+ installation as a fallback. This fallback uses Node.js's [`module.register()`](https://nodejs.org/api/module.html#moduleregisterspecifier-parenturl-options) API, introduced in Node.js 18.19 and 20.6. Configuration errors include their original diagnostics.
+Consumers can enable a compatible loader through Node.js startup options, such as `node --import tsx node_modules/prettier/bin/prettier.cjs . --write`. Override files are evaluated in workers, which inherit the runtime's startup preloads. Enable synchronous module hooks through a `--import` or `--require` preload so they are available in those workers. When the runtime reports unsupported module loading or TypeScript transformation, the plugin can use the consumer project's optional [`tsx`](https://github.com/privatenumber/tsx#readme) 4.19+ installation as a fallback. This fallback uses Node.js's [`module.register()`](https://nodejs.org/api/module.html#moduleregisterspecifier-parenturl-options) API, introduced in Node.js 18.19 and 20.6. Configuration errors include their original diagnostics.
 
 The Prettier VS Code extension uses its bundled Node.js runtime; JavaScript override files provide the simplest editor setup.