Extra space in argument's rendered markdown

[Boshen]

Rendered example:

Concrete example from test case codeblock_ticks_help:

bpaf/tests/markdown.rs

Line 245 in a479b6b

- **` --verbose`** — \n Verbose help

After an hour of debugging I found it's inserting the space here

bpaf/src/meta_help.rs

Line 510 in a479b6b

buf.write_str(" --", Style::Literal);

but removing it will break everything else.

And I wasn't able to hack it in the markdown renderer, the input

bpaf/src/buffer/html.rs

Line 326 in a479b6b

let input = &self.payload[byte_pos..byte_pos + bytes];

came in as

[src/buffer/html.rs:327:21] input = "    --verbose"

so the split below

bpaf/src/buffer/html.rs

Line 334 in a479b6b

for chunk in split(input) {

produces

[src/buffer/html.rs:335:31] chunk = Raw(
    " ",
    1,
)
[src/buffer/html.rs:335:31] chunk = Raw(
    " ",
    1,
)
[src/buffer/html.rs:335:31] chunk = Raw(
    " ",
    1,
)
[src/buffer/html.rs:335:31] chunk = Raw(
    " ",
    1,
)
[src/buffer/html.rs:335:31] chunk = Raw(
    "--verbose",
    9,
)

and I don't know what to do next, hence this issue 😅

[pacak]

Hmm... I'll see what I can do. I'm not really 100% happy with how markdown rendered either.

[Boshen]

Hmm... I'll see what I can do. I'm not really 100% happy with how markdown rendered either.

Side note: for other data sources I ended up parsing to another data structure and render some markdowns ... e.g. json schema to markdown: https://github.com/oxc-project/oxc/blob/main/tasks/website/src/linter/json_schema.rs

Maybe it's better to construct a data structure instead of collecting to html and then render from the html, the user could can use the data structure instead.

But this is a lot of rework 😅

[Boshen]

Thanks for the quick response!

While we are at it, my weirdly added doc comment https://github.com/oxc-project/oxc/blob/3671b5c4d0a56a2edd005bbd8710036ee61376d2/crates/oxc_cli/src/command/lint.rs#L79 produced something that looks like a missing newline

**Allowing / Denying Multiple Lints**###  For example `-D correctness -A no-debugger` or `-A all -D no-debugger`. ㅤ

Notice there is no newline before ###.