Leave alone Quarto-style comments ("#|")

CHANGES.md

@@ -10,6 +10,8 @@
 
 <!-- Changes that affect Black's stable style -->
 
+- Do not reformat Quarto-style metadata comments (`#| key: value`) (#3561)
+
 ### Preview style
 
 <!-- Changes that affect Black's preview style -->

docs/the_black_code_style/current_style.md

@@ -251,10 +251,11 @@ required due to an inner function starting immediately after.
 _Black_ does not format comment contents, but it enforces two spaces between code and a
 comment on the same line, and a space before the comment text begins. Some types of
 comments that require specific spacing rules are respected: doc comments (`#: comment`),
-section comments with long runs of hashes, and Spyder cells. Non-breaking spaces after
-hashes are also preserved. Comments may sometimes be moved because of formatting
-changes, which can break tools that assign special meaning to them. See
-[AST before and after formatting](#ast-before-and-after-formatting) for more discussion.
+section comments with long runs of hashes, Quarto-style metadata comments, and Spyder
+cells. Non-breaking spaces after hashes are also preserved. Comments may sometimes be
+moved because of formatting changes, which can break tools that assign special meaning
+to them. See [AST before and after formatting](#ast-before-and-after-formatting) for
+more discussion.
 
 ### Trailing commas
 

src/black/comments.py

@@ -29,7 +29,7 @@
 FMT_PASS: Final = {*FMT_OFF, *FMT_SKIP}
 FMT_ON: Final = {"# fmt: on", "# fmt:on", "# yapf: enable"}
 
-COMMENT_EXCEPTIONS = " !:#'"
+COMMENT_EXCEPTIONS = " !:#'|"
 
 
 @dataclass