`[br][br]` in docstring is not rendered properly in the hover widget

[OzelotVanilla]

Godot version

v4.8.dev3.official [51105ccbe]

VS Code version

1.132.0

Godot Tools VS Code extension version

2.7.1

System information

macOS 15.7.7

Issue description

In Godot docstring, [br][br] is not rendered as an empty new line, and it is omitted.

For example:

## Some sentences.[br][br]
##
## Some sentences.[br][br]
##
## Some sentences but only one br.[br]
##
## Some sentences.[br][br]
##
## Some sentences.[br][br]
func sometest():
    pass

It will generate hover widget like this:

[br] is not affected and it is rendered normally, while [br][br] is omitted.

In Godot, it will be rendered like this:

Steps to reproduce

1. Paste this code to any script file and hover onto the method name:

## Some sentences.[br][br]
##
## Some sentences.[br][br]
##
## Some sentences but only one br.[br]
##
## Some sentences.[br][br]
##
## Some sentences.[br][br]
func sometest():
    pass

2. Observe the result.

PS: I am happy to provide a PR to fix it (after this issue is considered as a bug and should be fixed).

[HolonProduction]

Could you please check the markdown content in the LSP trace? BBCode -> Markdown conversion happens on the server-side, so this might be the wrong repo for the report.

[OzelotVanilla]

Thank you for your response. Will try to find the correct place to sumbit this issue.

Got this conversion result from LSP trace.

\tfunc sometest()\n\nSome sentences.\nSome sentences.\nSome sentences but only one br.\n\nSome sentences.\nSome sentences.\n\nDefined in [res://test.gd](file:///Users/xxx/xxx/xxx/test.gd)

Which is from:

2026-08-22 18:31:23.568 [debug] tx: {"jsonrpc":"2.0","id":19,"method":"textDocument/hover","params":{"textDocument":{"uri":"file:///Users/xxx/xxx/xxx/test.gd"},"position":{"line":11,"character":10}}}
2026-08-22 18:31:23.576 [debug] rx: {"id":19,"jsonrpc":"2.0","result":{"contents":{"kind":"markdown","value":"\tfunc sometest()\n\nSome sentences.\nSome sentences.\nSome sentences but only one br.\n\nSome sentences.\nSome sentences.\n\nDefined in [res://test.gd](file:///Users/xxx/xxx/xxx/test.gd)"},"range":{"end":{"character":10,"line":11},"start":{"character":10,"line":11}}}}

Seems it is doing the conversation like:

[br]      --->  \n\n
[br][br]  --->  \n

Guess it should be something like ?

[br]      --->  <br />
[br][br]  --->  <p />

Wondering why \n is not rendered correctly...

[HolonProduction]

Iirc some editors don't support html tags (Zed I think). So we try to convert it in a way that looks fine in Markdown without html.

A single line break in markdown has no effect on the output. A new paragraph is started either by two line breaks or two trailing spaces at the end of the line.

The best solution would probably be to transform any sequence of [br] and whitespace to one paragraph break. I don't think there is a good way to maintain the exact amount of newlines in Markdown.