For AI agents: the complete documentation index is available at /annealer/llms.txt, the full documentation bundle is available at /annealer/llms-full.txt, and this page is available as Markdown at /annealer/guide/features/disable-directives.md.
Annealer
  • English

      • Disable directives

      Some code must keep its exact form, for example a third-party snippet or a legacy order kept on purpose. Comments switch annealer off for that code.

      <!-- annealer-disable -->
<!-- annealer-enable -->
<!-- annealer-disable-next-line: [reason] -->
      /* annealer-disable */
/* annealer-enable */
/* annealer-disable-next-line: [reason] */

      Rules

      • Block comments only. // is not supported, because CSS has no line comments.
      • annealer-disable covers everything after it, up to annealer-enable or the end of the document. At the top of a document, it leaves the file unchanged.
      • annealer-disable-next-line covers the constructs that start on the next line:
        • a start tag (the whole tag, even if it spans several lines, and a <style> element's content), or
        • a CSS statement (a declaration or a whole rule).
      • The reason after : is optional and ignored by annealer.
      • Covered code is kept verbatim and in place. In a stylesheet, covered declarations also stay where they are while their neighbors are sorted.
      • Scope: markup comments apply to markup (and to whole <style> elements). CSS comments apply inside the stylesheet they appear in.
      • Unknown directives are errors. A comment that starts with annealer- but is not a known directive (for example the typo annealer-disabel) fails the run instead of being ignored.
      <!-- annealer-disable-next-line: copied from the vendor's docs -->
<a href="/" id="vendor-link">Kept as written</a>
<a href="/" id="home">Reordered</a>

      Implementation note (stylesheets)

      A covered declaration keeps its position and ends the run of declarations sorted around it, so nothing moves across it. A covered rule is left exactly as written, nested blocks included. malva's own ignore comment (malva-ignore) is not used: it rejects the : reason form.