microsoft / tsdoc

A doc comment standard for TypeScript
https://tsdoc.org/
MIT License
4.73k stars 131 forks source link

[ Question ][ Playground ] Intended Behaviour? #371

Open PhoneDroid opened 9 months ago

PhoneDroid commented 9 months ago

Playing around with the Playground preview I notice that some
things break and don't render as they for example do in VSCode.

Gerrit0 commented 9 months ago

TSDoc does not support headings yet. #197

In general, TSDoc does not follow markdown. Most documentation tools render markdown, but because markdown isn't a format that can be trivially interpreted by a human, the TSDoc champions at Microsoft decided not to use it for TSDoc, just taking some of the same syntax.

PhoneDroid commented 9 months ago

It's used in your own docs .. https://tsdoc.org/pages/tags/example/#example-b