Fix some cssxref macro flaws

caugner · caugner · commit efe90c4452fd · 2026-05-11T23:46:15.000+02:00
diff --git a/files/en-us/web/css/guides/conditional_rules/index.md b/files/en-us/web/css/guides/conditional_rules/index.md
@@ -120,7 +120,7 @@ The CSS conditional rules module also introduces a `media()` CSS function. Curre
 
 - [CSS syntax](/en-US/docs/Web/CSS/Guides/Syntax) module
   - {{cssxref("@charset")}} declaration
-  - {{cssxref("at-rule")}} term
+  - [at-rule](/en-US/docs/Web/CSS/Guides/Syntax/At-rules) term
   - [`invalid`](/en-US/docs/Web/CSS/Guides/Syntax/Error_handling) term
   - {{glossary("parse")}} term
   - [style rule](/en-US/docs/Web/API/CSSStyleRule) term
diff --git a/files/en-us/web/css/guides/syntax/index.md b/files/en-us/web/css/guides/syntax/index.md
@@ -22,7 +22,7 @@ This module doesn't define any properties, [data types](/en-US/docs/Web/CSS/Refe
 
 ### Key concepts
 
-- {{cssxref("at-rule")}}
+- [At-rules](/en-US/docs/Web/CSS/Guides/Syntax/At-rules)
 - [character escaping](/en-US/docs/Web/CSS/Reference/Values/custom-ident#escaping_characters)
 - [CSS comments](/en-US/docs/Web/CSS/Guides/Syntax/Comments)
 - [CSS declaration](/en-US/docs/Web/API/CSS_Object_Model/CSS_Declaration)
diff --git a/files/en-us/web/css/reference/at-rules/@media/grid/index.md b/files/en-us/web/css/reference/at-rules/@media/grid/index.md
@@ -13,7 +13,7 @@ Most modern computers and smartphones have bitmap-based screens. Examples of gri
 
 ## Syntax
 
-The `grid` feature is specified as a {{cssxref("CSS_media_queries/Using_media_queries", "&lt;mq-boolean&gt;")}} value (`0` or `1`) representing whether or not the output device is grid-based.
+The `grid` feature is specified as a [`<mq-boolean>`](/en-US/docs/Web/CSS/Guides/Media_queries/Using) value (`0` or `1`) representing whether or not the output device is grid-based.
 
 ## Examples
 
diff --git a/files/en-us/web/css/reference/properties/content/index.md b/files/en-us/web/css/reference/properties/content/index.md
@@ -111,11 +111,11 @@ The keywords and data types mentioned above are described in more detail below:
   - : An {{cssxref("image")}}, representing an image to display. This can be equal to a {{cssxref("url_value", "&lt;url&gt;")}}, {{cssxref("image/image-set", "image-set()")}}, or {{cssxref("gradient")}} data type, or a part of the webpage itself, defined by the {{cssxref("element()")}} function.
 
 - `<counter>`
-  - : The `<counter>` value is a [CSS counter](/en-US/docs/Web/CSS/Guides/Counter_styles/Using_counters), generally a number produced by computations defined by {{cssxref("&lt;counter-reset&gt;")}} and {{cssxref("&lt;counter-increment&gt;")}} properties. It can be displayed using either the {{cssxref("counter()")}} or {{cssxref("counters()")}} function.
+  - : The `<counter>` value is a [CSS counter](/en-US/docs/Web/CSS/Guides/Counter_styles/Using_counters), generally a number produced by computations defined by {{cssxref("counter-reset")}} and {{cssxref("counter-increment")}} properties. It can be displayed using either the {{cssxref("counter()")}} or {{cssxref("counters()")}} function.
     - {{cssxref("counter()")}}
-      - : The {{cssxref("counter()")}} function has two forms: 'counter(_name_)' or 'counter(_name_, style)'. The generated text is the value of the innermost counter of the given name in scope at the given pseudo-element. It is formatted in the specified {{cssxref("&lt;list-style-type&gt;")}} (`decimal` by default).
+      - : The {{cssxref("counter()")}} function has two forms: 'counter(_name_)' or 'counter(_name_, style)'. The generated text is the value of the innermost counter of the given name in scope at the given pseudo-element. It is formatted in the specified {{cssxref("list-style-type")}} (`decimal` by default).
     - {{cssxref("counters()")}}
-      - : The {{cssxref("counters()")}} function also has two forms: 'counters(_name_, _string_)' or 'counters(_name_, _string_, _style_)'. The generated text is the value of all counters with the given name in scope at the given pseudo-element, from outermost to innermost, separated by the specified string. The counters are rendered in the indicated {{cssxref("&lt;list-style-type&gt;")}} (`decimal` by default).
+      - : The {{cssxref("counters()")}} function also has two forms: 'counters(_name_, _string_)' or 'counters(_name_, _string_, _style_)'. The generated text is the value of all counters with the given name in scope at the given pseudo-element, from outermost to innermost, separated by the specified string. The counters are rendered in the indicated {{cssxref("list-style-type")}} (`decimal` by default).
 
 - `<quote>`
   - : The `<quote>` data type includes language- and position-dependent keywords:
diff --git a/files/en-us/web/css/reference/properties/flex/index.md b/files/en-us/web/css/reference/properties/flex/index.md
@@ -102,8 +102,8 @@ flex: unset;
 The `flex` property may be specified using one, two, or three values.
 
 - **One-value syntax:** the value must be one of:
-  - a valid value for {{cssxref("&lt;flex-grow&gt;")}}: then, in all the browsers, the shorthand expands to `flex: <flex-grow> 1 0%`. However the specification says it should expand to `flex: <flex-grow> 1 0`.
-  - a valid value for {{cssxref("&lt;flex-basis&gt;")}}: then the shorthand expands to `flex: 1 1 <flex-basis>`.
+  - a valid value for {{cssxref("flex-grow")}}: then, in all the browsers, the shorthand expands to `flex: <flex-grow> 1 0%`. However the specification says it should expand to `flex: <flex-grow> 1 0`.
+  - a valid value for {{cssxref("flex-basis")}}: then the shorthand expands to `flex: 1 1 <flex-basis>`.
   - the keyword `none` or one of the global keywords.
 
 - **Two-value syntax:**
diff --git a/files/en-us/web/css/reference/properties/font/index.md b/files/en-us/web/css/reference/properties/font/index.md
@@ -112,15 +112,15 @@ If `font` is specified as a system keyword, it must be one of: `caption`, `icon`
 If `font` is specified as a shorthand for several font-related properties, then:
 
 - it must include values for:
-  - {{cssxref("&lt;font-size&gt;")}}
-  - {{cssxref("&lt;font-family&gt;")}}
+  - {{cssxref("font-size")}}
+  - {{cssxref("font-family")}}
 
 - it may optionally include values for:
-  - {{cssxref("&lt;font-style&gt;")}}
-  - {{cssxref("&lt;font-variant&gt;")}}
-  - {{cssxref("&lt;font-weight&gt;")}}
-  - {{cssxref("&lt;font-stretch&gt;")}}
-  - {{cssxref("&lt;line-height&gt;")}}
+  - {{cssxref("font-style")}}
+  - {{cssxref("font-variant")}}
+  - {{cssxref("font-weight")}}
+  - {{cssxref("font-stretch")}}
+  - {{cssxref("line-height")}}
 
 - `font-style`, `font-variant` and `font-weight` must precede `font-size`.
 - `font-variant` may only specify the values defined in CSS 2.1, that is `normal` and `small-caps`.
diff --git a/files/en-us/web/css/reference/selectors/_doublecolon_view-transition-group/index.md b/files/en-us/web/css/reference/selectors/_doublecolon_view-transition-group/index.md
@@ -52,7 +52,7 @@ In addition, the element's transform is animated from the "old" view state's scr
 - `<pt-class-selector>`
   - : The {{cssxref("custom-ident")}} set as the value of the {{cssxref("view-transition-class")}} property, preceded by a period (`.`).
 
-The {{cssxref("specificity")}} of the named view transition pseudo-element is equal to the [specificity of the type selector](/en-US/docs/Web/CSS/Guides/Cascade/Specificity#type_column), unless the parameter used is the universal selector is used, in which case the specificity is zero.
+The [specificity](/en-US/docs/Web/CSS/Guides/Cascade/Specificity) of the named view transition pseudo-element is equal to the [specificity of the type selector](/en-US/docs/Web/CSS/Guides/Cascade/Specificity#type_column), unless the parameter used is the universal selector is used, in which case the specificity is zero.
 
 ## Examples
 
diff --git a/files/en-us/web/css/reference/values/basic-shape/path/index.md b/files/en-us/web/css/reference/values/basic-shape/path/index.md
@@ -179,7 +179,7 @@ svg {
 
 ## See also
 
-- {{cssxref("&lt;shape-outside&gt;")}}
+- {{cssxref("shape-outside")}}
 - [CSS shapes](/en-US/docs/Web/CSS/Guides/Shapes) module
 - [Overview of CSS shapes](/en-US/docs/Web/CSS/Guides/Shapes/Overview)
 - [The SVG `path` syntax: an illustrated guide](https://css-tricks.com/svg-path-syntax-illustrated-guide/) via CSS-tricks (2021)
diff --git a/files/en-us/web/css/reference/values/calc/index.md b/files/en-us/web/css/reference/values/calc/index.md
@@ -102,7 +102,7 @@ When an {{cssxref("&lt;integer&gt;")}} is expected, the `calc()` expression can
 
 ### Input considerations
 
-- `calc()` cannot perform calculations on [intrinsic size values](/en-US/docs/Glossary/Intrinsic_Size) such as {{cssxref("auto")}} and {{cssxref("fit-content")}}. Use the {{cssxref("calc-size()")}} function instead.
+- `calc()` cannot perform calculations on [intrinsic size values](/en-US/docs/Glossary/Intrinsic_Size) such as {{cssxref("width#auto", "`auto`"}} and {{cssxref("fit-content")}}. Use the {{cssxref("calc-size()")}} function instead.
 - The `*` and `/` operators do not require whitespace, but adding it for consistency is recommended.
 - It is permitted to nest `calc()` functions, in which case, the inner ones are treated as simple parentheses.
 - Math expressions involving percentages for widths and heights on table columns, table column groups, table rows, table row groups, and table cells in both auto and fixed layout tables _may_ be treated as if `auto` is specified.
diff --git a/files/en-us/web/css/reference/values/counter/index.md b/files/en-us/web/css/reference/values/counter/index.md
@@ -58,7 +58,7 @@ The `counter()` function accepts up to two parameters. The first parameter is th
 - `<counter-name>`
   - : A {{cssxref("&lt;custom-ident&gt;")}} identifying the counter, which is the same case-sensitive name used with the {{cssxref("counter-reset")}} and {{cssxref("counter-increment")}} property values. The counter name cannot start with two dashes and can't be `none`, `unset`, `initial`, or `inherit`.
 - `<counter-style>`
-  - : A {{cssxref("&lt;list-style-type&gt;")}} name, {{cssxref("&lt;@counter-style&gt;")}} name or {{cssxref("symbols()")}} function, where a counter style name is a `numeric`, `alphabetic`, or `symbolic` predefined counter style, a complex longhand east Asian or Ethiopic predefined counter style, or other [predefined counter style](/en-US/docs/Web/CSS/Guides/Counter_styles). If omitted, the counter-style defaults to `decimal`.
+  - : A {{cssxref("list-style-type")}} name, {{cssxref("&lt;counter-style-name&gt;")}} or {{cssxref("symbols()")}} function, where a counter style name is a `numeric`, `alphabetic`, or `symbolic` predefined counter style, a complex longhand east Asian or Ethiopic predefined counter style, or other [predefined counter style](/en-US/docs/Web/CSS/Guides/Counter_styles). If omitted, the counter-style defaults to `decimal`.
 
 > [!NOTE]
 > To join the counter values when nesting counters, use the {{cssxref("counters()")}} function, which provides an additional {{cssxref("string")}} parameter.
diff --git a/files/en-us/web/css/reference/values/data_types/index.md b/files/en-us/web/css/reference/values/data_types/index.md
@@ -121,7 +121,7 @@ The [CSS images](/en-US/docs/Web/CSS/Guides/Images) module defines the data type
 
 ## 2D positioning
 
-The {{cssxref("&lt;position&gt;")}} data type is interpreted as defined for the {{cssxref("&lt;background-position&gt;")}} property.
+The {{cssxref("&lt;position&gt;")}} data type is interpreted as defined for the {{cssxref("background-position")}} property.
 
 - {{cssxref("&lt;position&gt;")}}
   - : Defines the position of an object area. Accepts a keyword value such as `top` or `left`, or a `<length-percentage>`.
