When using a documentation.yml file like this

toc:
  - name: section
    description: >
      My cool description with a [markdown link](https://github.com/cool/link). And other things.

This will result in a truncated output of the description of

My cool description with a [markdown link](https:

The reason for this is that the json comment stripping is done on the yml file here.