prettier/prettier

HTML comments in markdown get endlessly indented

Open

#18 066 ouverte le 13 oct. 2025

Voir sur GitHub
 (2 commentaires) (0 réactions) (1 assigné)JavaScript (51 868 stars) (4 716 forks)batch import
help wantedlang:markdown

Description

Prettier 3.6.2 Playground link

--parser markdown

Input:

- Something:
  - [ ] Foo
  - [ ] Bar
        <!--
          Something else
        -->

Output:

- Something:
  - [ ] Foo
  - [ ] Bar
        <!--
              Something else
            -->

Second Output:

- Something:
  - [ ] Foo
  - [ ] Bar
        <!--
                  Something else
                -->

Expected output:

- Something:
  - [ ] Foo
  - [ ] Bar
        <!--
          Something else
        -->

Why?

IMO, the comment is hanging under the "Bar" item, so it should be indented one level more than it. <!-- and --> should be at the same level. And a re-format should not keep pushing the contents ever to the right.

Guide contributeur

Stack technique
javascriptnodejs
Domaine
toolingdeveloper experience
Type d'issue
bug
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 hours
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
blocked
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
clear
Prérequis
Understanding of Prettier's markdown parserBasic knowledge of AST traversal
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
40
Direction de recherche
The issue is about HTML comments inside list items in markdown being indented incorrectly. Start by locating the markdown printer in Prettier's source, likely in `src/language markdown/printer markdown.js`. Focus on the logic that handles indentation of HTML comments within list items. Look for how comments are treated in the context of list item indentation. The playground link shows the problem; replicate it and trace the indentation calculations. Check if there is an existing test for similar cases. The fix likely involves adjusting the indentation level for comment nodes relative to their parent list item.