docs: improve param documentation

[Myriad-Dreamin]

No description provided.

[OrangeX4]

How to make tinymist to support #example()? Syntax like

/// #example(`
/// #alternatives-match((
///   "1, 3-5": [this text has the majority],
///   "2, 6": [this is shown less often]
/// ))
/// `)

will make docs disappear.

[OrangeX4]

Now I'm using

/// Example: `#something()`

[Myriad-Dreamin]

We can completely follow format of tidy docs rather than workaround bugs, as we'll finally fix them. And, we can add more features if there should be missing ones.