[pull] main from mdn:main

files/en-us/web/css/guides/text_decoration/index.md

@@ -77,6 +77,7 @@ p {
 
 - {{cssxref("text-decoration")}}
 - {{cssxref("text-decoration-color")}}
+- {{cssxref("text-decoration-inset")}}
 - {{cssxref("text-decoration-line")}}
 - {{cssxref("text-decoration-skip")}}
 - {{cssxref("text-decoration-skip-ink")}}
@@ -90,7 +91,7 @@ p {
 - {{cssxref("text-underline-offset")}}
 - {{cssxref("text-underline-position")}}
 
-The specification also defines the `text-decoration-skip-box`, `text-decoration-skip-self`, `text-decoration-skip-spaces`, `text-decoration-trim`, and `text-emphasis-skip` properties, which are not yet supported by any browser.
+The specification also defines the `text-decoration-skip-box`, `text-decoration-skip-self`, `text-decoration-skip-spaces`, and `text-emphasis-skip` properties, which are not yet supported by any browser.
 
 ## Guides
 

files/en-us/web/css/reference/properties/caret/index.md

@@ -55,9 +55,9 @@ div {
 
 This property is a shorthand for the following CSS properties:
 
-- [`caret-color`](/en-US/docs/Web/CSS/Reference/Properties/caret-color)
-- [`caret-animation`](/en-US/docs/Web/CSS/Reference/Properties/caret-animation)
-- [`caret-shape`](/en-US/docs/Web/CSS/Reference/Properties/caret-shape)
+- {{cssxref("caret-color")}}
+- {{cssxref("caret-animation")}}
+- {{cssxref("caret-shape")}}
 
 ## Syntax
 

files/en-us/web/css/reference/properties/clip-path/index.md

@@ -278,7 +278,7 @@ We include two {{htmlElement("div")}} elements and an `<svg>` element containing
 
 #### CSS
 
-We use [flexbox](/en-US/docs/Web/CSS/Guides/Flexible_box_layout) to allow our elements to sit side-by-side with a gap between them, if there is space available. We define a {{cssxref("gradient/conic-gradient", "conic-gradient()")}} background image on both `<div>` elements, providing an interesting visual to clip, along with a {{cssxref("border")}}.
+We use [flexbox](/en-US/docs/Web/CSS/Guides/Flexible_box_layout) to allow our elements to sit side-by-side with a gap between them, if there is space available. We define a {{cssxref("conic-gradient()")}} background image on both `<div>` elements, providing an interesting visual to clip, along with a {{cssxref("border")}}.
 
 ```css
 body {

files/en-us/web/css/reference/properties/clip-rule/index.md

@@ -128,7 +128,7 @@ We include an SVG with two `<clipPath>` elements that define star shapes, which
 
 #### CSS
 
-We provide the `<div>` elements with a set {{cssxref("width")}} and {{cssxref("height")}}, adding a [`conic-gradient()`](/en-US/docs/Web/CSS/Reference/Values/gradient/conic-gradient) for their {{cssxref("background-image")}} value:
+We provide the `<div>` elements with a set {{cssxref("width")}} and {{cssxref("height")}}, adding a {{cssxref("conic-gradient()")}} for their {{cssxref("background-image")}} value:
 
 ```css hidden
 body {

files/en-us/web/css/reference/properties/columns/index.md

@@ -49,8 +49,8 @@ columns: 3;
 
 This property is a shorthand for the following CSS properties:
 
-- [`column-count`](/en-US/docs/Web/CSS/Reference/Properties/column-count)
-- [`column-width`](/en-US/docs/Web/CSS/Reference/Properties/column-width)
+- {{cssxref("column-count")}}
+- {{cssxref("column-width")}}
 
 ## Syntax
 

files/en-us/web/css/reference/properties/contain-intrinsic-block-size/index.md

@@ -45,7 +45,7 @@ The following values can be specified for the intrinsic block size of an element
 
 ## Description
 
-The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility).
+The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and {{cssxref("content-visibility")}}.
 
 Size containment allows a user agent to lay out an element as though it had a fixed size.
 This prevents unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
@@ -76,7 +76,7 @@ The HTML below defines an element "contained_element" that will be subject to si
 </div>
 ```
 
-The CSS below sets the [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility) of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
+The CSS below sets the {{cssxref("content-visibility")}} of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
 The intrinsic block size and inline size that are used when it is size constrained are set at the same time using `contain-intrinsic-block-size` and `contain-intrinsic-inline-size`, respectively.
 
 ```css

files/en-us/web/css/reference/properties/contain-intrinsic-height/index.md

@@ -42,7 +42,7 @@ The following values may be specified for an element.
 
 ## Description
 
-The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility), and may also be set using the [`contain-intrinsic-size`](/en-US/docs/Web/CSS/Reference/Properties/contain-intrinsic-size) [shorthand property](/en-US/docs/Web/CSS/Guides/Cascade/Shorthand_properties).
+The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and {{cssxref("content-visibility")}}, and may also be set using the {{cssxref("contain-intrinsic-size")}} [shorthand property](/en-US/docs/Web/CSS/Guides/Cascade/Shorthand_properties).
 
 Size containment allows a user agent to lay out an element as though it had a fixed size, preventing unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
 By default, size containment treats elements as though they had no contents, and may collapse the layout in the same way as if the contents had no height (or width).
@@ -74,7 +74,7 @@ The HTML below defines an element "contained_element" that will be subject to si
 </div>
 ```
 
-The CSS below sets the [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility) of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
+The CSS below sets the {{cssxref("content-visibility")}} of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
 The width and height that are used when it is size constrained are set at the same time using `contain-intrinsic-width` and `contain-intrinsic-height`, respectively.
 
 ```css

files/en-us/web/css/reference/properties/contain-intrinsic-inline-size/index.md

@@ -46,7 +46,7 @@ The following values can be specified for the intrinsic inline size of an elemen
 
 ## Description
 
-The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility).
+The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and {{cssxref("content-visibility")}}.
 
 Size containment allows a user agent to lay out an element as though it had a fixed size, preventing unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
 By default, size containment treats elements as though they had no contents, and may collapse the layout in the same way as if the contents had no width or height.
@@ -76,7 +76,7 @@ The HTML below defines an element "contained_element" that will be subject to si
 </div>
 ```
 
-The CSS below sets the [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility) of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
+The CSS below sets the {{cssxref("content-visibility")}} of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
 The intrinsic block size and inline size that are used when it is size constrained are set at the same time using `contain-intrinsic-block-size` and `contain-intrinsic-inline-size`, respectively.
 
 ```css

files/en-us/web/css/reference/properties/contain-intrinsic-size/index.md

@@ -12,8 +12,8 @@ The **`contain-intrinsic-size`** [CSS](/en-US/docs/Web/CSS) [shorthand property]
 
 This property is a shorthand for the following CSS properties:
 
-- [`contain-intrinsic-width`](/en-US/docs/Web/CSS/Reference/Properties/contain-intrinsic-width)
-- [`contain-intrinsic-height`](/en-US/docs/Web/CSS/Reference/Properties/contain-intrinsic-height)
+- {{cssxref("contain-intrinsic-width")}}
+- {{cssxref("contain-intrinsic-height")}}
 
 ## Syntax
 
@@ -62,7 +62,7 @@ If two `auto [<length> | none]` pairs are specified, the first pair applies to t
 
 ## Description
 
-The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility).
+The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and {{cssxref("content-visibility")}}.
 
 Size containment allows a user agent to lay out an element as though it had a fixed size, preventing unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
 By default, size containment treats elements as though they had no contents, and may collapse the layout in the same way as if the contents had no width or height.

files/en-us/web/css/reference/properties/contain-intrinsic-width/index.md

@@ -42,7 +42,7 @@ The following values may be specified for an element.
 
 ## Description
 
-The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility), and may also be set using the [`contain-intrinsic-size`](/en-US/docs/Web/CSS/Reference/Properties/contain-intrinsic-size) [shorthand property](/en-US/docs/Web/CSS/Guides/Cascade/Shorthand_properties).
+The property is commonly applied alongside elements that can trigger size containment, such as [`contain: size`](/en-US/docs/Web/CSS/Reference/Properties/contain) and {{cssxref("content-visibility")}}, and may also be set using the {{cssxref("contain-intrinsic-size")}} [shorthand property](/en-US/docs/Web/CSS/Guides/Cascade/Shorthand_properties).
 
 Size containment allows a user agent to lay out an element as though it had a fixed size, preventing unnecessary reflows by avoiding the re-rendering of child elements to determine the actual size (thereby improving user experience).
 By default, size containment treats elements as though they had no contents, and may collapse the layout in the same way as if the contents had no width or height.
@@ -74,7 +74,7 @@ The HTML below defines an element "contained_element" that will be subject to si
 </div>
 ```
 
-The CSS below sets the [`content-visibility`](/en-US/docs/Web/CSS/Reference/Properties/content-visibility) of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
+The CSS below sets the {{cssxref("content-visibility")}} of `contained_element` to `auto`, so if the element is hidden it will be size constrained.
 The width and height that are used when it is size constrained are set at the same time using `contain-intrinsic-width` and `contain-intrinsic-height`, respectively.
 
 ```css

files/en-us/web/css/reference/properties/contain/index.md

@@ -300,7 +300,7 @@ Style containment causes the {{cssxref("counter-increment")}} property to be sco
 
 #### Containment and quotes
 
-CSS quotes are similarly affected in that the [`content`](/en-US/docs/Web/CSS/Reference/Properties/content) values relating to quotes are scoped to the element:
+CSS quotes are similarly affected in that the {{cssxref("content")}} values relating to quotes are scoped to the element:
 
 ```html
 <!-- With style containment -->

files/en-us/web/css/reference/properties/content-visibility/index.md

@@ -95,7 +95,7 @@ This behavior is useful for creating entry/exit animations where you want to, fo
 When animating `content-visibility` with [CSS transitions](/en-US/docs/Web/CSS/Guides/Transitions), [`transition-behavior: allow-discrete`](/en-US/docs/Web/CSS/Reference/Properties/transition-behavior) needs to be set on `content-visibility`. This effectively enables `content-visibility` transitions.
 
 > [!NOTE]
-> When transitioning an element's `content-visibility` value, you don't need to provide a set of starting values for transitioned properties using a [`@starting-style`](/en-US/docs/Web/CSS/Reference/At-rules/@starting-style) block, like you do when [transitioning `display`](/en-US/docs/Web/CSS/Reference/Properties/display#animating_display). This is because `content-visibility` doesn't hide an element from the DOM like `display` does: it just skips rendering the element's content.
+> When transitioning an element's `content-visibility` value, you don't need to provide a set of starting values for transitioned properties using a {{cssxref("@starting-style")}} block, like you do when [transitioning `display`](/en-US/docs/Web/CSS/Reference/Properties/display#animating_display). This is because `content-visibility` doesn't hide an element from the DOM like `display` does: it just skips rendering the element's content.
 
 ## Formal definition
 
@@ -230,7 +230,7 @@ In this example, we have a {{htmlelement("div")}} element, the content of which
 
 #### CSS
 
-In the CSS we initially set `content-visibility: hidden;` on the `<div>` to hide its content. We then set up `@keyframes` animations and attach them to classes to show and hide the `<div>`, animating `content-visibility` and [`color`](/en-US/docs/Web/CSS/Reference/Properties/color) so that you get a smooth animation effect as the content is shown/hidden.
+In the CSS we initially set `content-visibility: hidden;` on the `<div>` to hide its content. We then set up `@keyframes` animations and attach them to classes to show and hide the `<div>`, animating `content-visibility` and {{cssxref("color")}} so that you get a smooth animation effect as the content is shown/hidden.
 
 ```css
 div {
@@ -319,6 +319,6 @@ The rendered result looks like this:
 ## See also
 
 - [CSS Containment](/en-US/docs/Web/CSS/Guides/Containment)
-- [`contain-intrinsic-size`](/en-US/docs/Web/CSS/Reference/Properties/contain-intrinsic-size)
+- {{cssxref("contain-intrinsic-size")}}
 - {{domxref("element/contentvisibilityautostatechange_event", "contentvisibilityautostatechange")}}
 - [content-visibility: the new CSS property that boosts your rendering performance](https://web.dev/articles/content-visibility) (web.dev)

files/en-us/web/css/reference/properties/content/index.md

@@ -376,7 +376,7 @@ When generating content on regular elements (rather than just on pseudo-elements
 
 ### Element replacement with `<gradient>`
 
-This example demonstrates how an element's contents can be replaced by any type of `<image>`, in this case, a CSS gradient. The element's contents are replaced with a {{cssxref("gradient/linear-gradient", "linear-gradient()")}}. We provide alt text because all images should be described for accessibility.
+This example demonstrates how an element's contents can be replaced by any type of `<image>`, in this case, a CSS gradient. The element's contents are replaced with a {{cssxref("linear-gradient()")}}. We provide alt text because all images should be described for accessibility.
 
 #### HTML
 

files/en-us/web/css/reference/properties/display/index.md

@@ -318,13 +318,13 @@ There is one exception, which is when animating to or from `display: none`. In t
 - When animating `display` from `none` to `block` (or another visible `display` value), the value will flip to `block` at `0%` of the animation duration so it is visible throughout.
 - When animating `display` from `block` (or another visible `display` value) to `none`, the value will flip to `none` at `100%` of the animation duration so it is visible throughout.
 
-This behavior is useful for creating entry/exit animations where you want to for example remove a container from the DOM with `display: none`, but have it fade out with [`opacity`](/en-US/docs/Web/CSS/Reference/Properties/opacity) rather than disappearing immediately.
+This behavior is useful for creating entry/exit animations where you want to for example remove a container from the DOM with `display: none`, but have it fade out with {{cssxref("opacity")}} rather than disappearing immediately.
 
 When animating `display` with [CSS animations](/en-US/docs/Web/CSS/Guides/Animations), you need to provide the starting `display` value in an explicit keyframe (for example using `0%` or `from`). See [Using CSS animations](/en-US/docs/Web/CSS/Guides/Animations/Using) for an example.
 
 When animating `display` with [CSS transitions](/en-US/docs/Web/CSS/Guides/Transitions), two additional features are needed:
 
-- [`@starting-style`](/en-US/docs/Web/CSS/Reference/At-rules/@starting-style) provides starting values for properties you want to transition from when the animated element is first shown. This is needed to avoid unexpected behavior. By default, CSS transitions are not triggered on an element's first style update or when the `display` type changes from `none` to another type.
+- {{cssxref("@starting-style")}} provides starting values for properties you want to transition from when the animated element is first shown. This is needed to avoid unexpected behavior. By default, CSS transitions are not triggered on an element's first style update or when the `display` type changes from `none` to another type.
 - [`transition-behavior: allow-discrete`](/en-US/docs/Web/CSS/Reference/Properties/transition-behavior) needs to be set on the {{cssxref("transition-property")}} declaration (or the {{cssxref("transition")}} shorthand) to enable `display` transitions.
 
 For examples of transitioning the `display` property, see the [`@starting-style`](/en-US/docs/Web/CSS/Reference/At-rules/@starting-style#examples) and [`transition-behavior`](/en-US/docs/Web/CSS/Reference/Properties/transition-behavior#examples) pages.

files/en-us/web/css/reference/properties/flex-flow/index.md

@@ -59,8 +59,8 @@ flex-flow: column wrap;
 
 This property is a shorthand for the following CSS properties:
 
-- [`flex-direction`](/en-US/docs/Web/CSS/Reference/Properties/flex-direction)
-- [`flex-wrap`](/en-US/docs/Web/CSS/Reference/Properties/flex-wrap)
+- {{cssxref("flex-direction")}}
+- {{cssxref("flex-wrap")}}
 
 ## Syntax
 

files/en-us/web/css/reference/properties/font-palette/index.md

@@ -6,7 +6,7 @@ browser-compat: css.properties.font-palette
 sidebar: cssref
 ---
 
-The **`font-palette`** [CSS](/en-US/docs/Web/CSS) property allows specifying one of the many palettes contained in a [color font](https://www.colorfonts.wtf/) that a user agent may use for the font. Users can also override the values in a palette or create a new palette by using the [`@font-palette-values`](/en-US/docs/Web/CSS/Reference/At-rules/@font-palette-values) at-rule.
+The **`font-palette`** [CSS](/en-US/docs/Web/CSS) property allows specifying one of the many palettes contained in a [color font](https://www.colorfonts.wtf/) that a user agent may use for the font. Users can also override the values in a palette or create a new palette by using the {{cssxref("@font-palette-values")}} at-rule.
 
 > [!NOTE]
 > A `font-palette` palette takes precedence when coloring a font. The {{cssxref("color")}} property will not override a font palette, even if specified with {{cssxref("important", "!important")}}.