[clang-tools-extra] [clangd] Improve Markup Rendering (PR #140498)

Maksim Ivanov via cfe-commits cfe-commits at lists.llvm.org
Tue Jun 24 05:15:04 PDT 2025


================
@@ -118,8 +138,8 @@ class Document {
   BulletList &addBulletList();
 
   /// Doesn't contain any trailing newlines.
-  /// We try to make the markdown human-readable, e.g. avoid extra escaping.
-  /// At least one client (coc.nvim) displays the markdown verbatim!
----------------
emaxx-google wrote:

Sounds good generally! Thanks.

Just a quick question:

> Plaintext (default): the old escaping behaviour and no doxygen command parsing. The only thing I would still change is the paragraph termination with 2 newlines instead of 1.

A single blank line between paragraphs sounds OK. If you mean adding another blank line in between, or a trailing blank line at the end, that might look extraneous. In any case, that sounds like a relatively minor implementation detail that we can discuss further as the PR goes.

https://github.com/llvm/llvm-project/pull/140498


More information about the cfe-commits mailing list