Enable markdownlint checks for shortcut links

.markdownlint-cli2.yaml

@@ -1,4 +1,4 @@
-# globs: ["**.md"]
+globs: ["**.md"]
 ignores: ["node_modules/**"]
 config:
   # BNF syntax examples can go over length, and there's no way to exempt them
@@ -24,4 +24,7 @@ config:
   # We use spaces in code formatting because spaces are relevant in Sass.
   no-space-in-code: false
 
+  reference-links-images:
+    shortcut_syntax: true
+
   first-line-heading: false

accepted/calc-functions.md

@@ -816,6 +816,8 @@ compiler.
 
 A private property like [`Value.internal`] that refers to a Sass string.
 
+[`Value.internal`]: ../spec/js-api/value/index.d.ts.md#internal
+
 ##### Constructor
 
 Creates a `CalculationInterpolation` with its `internal` set to an unquoted Sass

accepted/color-4-new-spaces.md

@@ -1239,8 +1239,8 @@ normalized channel value otherwise.
   * Otherwise, set `channel` to the result of [percent-converting] `channel`
     with a `min` and `max` defined by the `valid` channel range.
 
-  * If this was (transitively) invoked from the global [`rgb()`, `lab()`,
+  * If this was (transitively) invoked from the global `rgb()`, `lab()`,
-    `lch()`, `oklab()`, `oklch()`, or `color()`] function and `valid` is a
+    `lch()`, `oklab()`, `oklch()`, or `color()` function and `valid` is a
     clamped channel, return the result of clamping `channel` to its native
     range.
 

accepted/prev-url.d.ts.md

@@ -41,6 +41,8 @@ to access the URL of the stylesheet that contained the load, known in the legacy
 API as the "previous URL". This was an intentional design choice which enforced
 the invariant that the same canonical URL always refers to the same file.
 
+[new importer API]: new-js-importer.d.ts.md
+
 However, this restriction makes it difficult for importers to work as expected
 in certain contexts. For example, in the Node.js ecosystem JS loads depend on
 the structure of the `node_modules` directory closest to the containing file.

proposal/interleaved-declarations.md

@@ -141,6 +141,8 @@ should have a period of deprecation in which it emits a deprecation warning for
 a declaration whose `parent` is not the last statement in [the current module]'s
 CSS without changing the existing behavior.
 
+[the current module]: ../spec/spec.md#current-module
+
 > Authors can move interleaved declarations before any nested rules to preserve
 > existing behavior, or nest them in `& { ... }` style rules to anticipate the
 > new behavior.

spec/embedded-protocol.md

@@ -143,6 +143,8 @@ since they're not specific to any individual compilation.
 The compilation ID and normal request `id` `4294967295` is reserved for [error
 handling]. (This is the maximum number representable by a `uint32`.)
 
+[error handling]: #error-handling
+
 ### Optional and Mandatory Fields
 
 If a field is not optional, the the endpoint that sends that message must

spec/js-api/value/calculation.d.ts.md

@@ -39,6 +39,8 @@ import {Value, SassNumber, SassString} from './index';
 
 The type of values that can be arguments to a [`SassCalculation`].
 
+[`SassCalculation`]: #sasscalculation
+
 ```ts
 export type CalculationValue =
   | SassNumber
@@ -161,6 +163,8 @@ export type CalculationOperator = '+' | '-' | '*' | '/';
 
 The JS API representation of a Sass [`CalculationOperation`].
 
+[`CalculationOperation`]: #calculationoperation
+
 ```ts
 export class CalculationOperation implements ValueObject {
 ```

spec/js-api/value/index.d.ts.md

@@ -276,6 +276,8 @@ Returns `this` interpreted as a map.
 
 * If `this` is a [`SassMap`], return `this`.
 
+  [`SassMap`]: map.d.ts.md
+
 * Otherwise, if [`internal`] is an empty Sass list, return a `SassMap` with its
   `internal` set to an empty map.
 

spec/js-api/value/string.d.ts.md

@@ -48,6 +48,8 @@ Creates a Sass string:
 * Set [`internal`] to a Sass string with contents set to `text` and quoted set
   to `quotes`.
 
+  [`internal`]: #internal
+
 * Return `this`.
 
 ```ts

spec/syntax.md

@@ -275,6 +275,8 @@ SCSS:
   adjacent `/`s in a [`SlashListExpression`] may have no whitespace between
   them, so `//` is parsed as two slash separators in a slash-separated list.
 
+  [`SlashListExpression`]: types/list.md#SlashListExpression
+
 * A `ParentSelector` may appear anywhere in a `CompoundSelector`, rather than
   just as the first `SimpleSelector`.
 

spec/types/calculation.md

@@ -150,6 +150,8 @@ To serialize a `Number` within a `CalculationExpression`:
 This algorithm takes a [`FunctionCall`] `call` whose name is a plain identifier
 and returns a number or a calculation.
 
+[`FunctionCall`]: ../functions.md#functioncall
+
 * If `call`'s `ArgumentInvocation` contains one or more `KeywordArgument`s or
   one or more `RestArgument`s, throw an error.
 
@@ -226,6 +228,8 @@ This algorithm takes an expression `expression` and returns a
 
 * If `expression` isn't [calculation-safe], throw an error.
 
+  [calculation-safe]: #calculation-safe-expression
+
 * Otherwise, evaluate `expression` using the semantics defined in the
   [Semantics] section if available, or the standard semantics otherwise.
 
@@ -416,7 +420,9 @@ This algorithm takes a calculation `calc` and returns a number or a calculation.
         * If `strategy`'s value is `"to-zero"`, return whichever of `upper` and
           `lower` has the smallest absolute difference from 0.
 
+  [exactly equal]: number.md#exact-equality
   [special variable string]: ../functions.md#special-variable-string
+  [matching units]: number.md#matching-two-numbers-units
 
 * If `calc`'s name is `"clamp"`:
 

spec/types/list.md

@@ -51,7 +51,7 @@ absolute value is larger than the length of that list.
 ## Syntax
 
 <x><pre>
-**BracketedListExpression** ::= '[' ContainedListExpression ']'
+**BracketedListExpression** ::= '\[' ContainedListExpression ']'
 **ContainedListExpression** ::= CommaListExpression ','?
 **CommaListExpression**     ::= SlashListExpression (',' SlashListExpression)*
 **SlashListExpression**     ::= SpaceListExpression (('/' SpaceListExpression?)* '/' SpaceListExpression)?