Using this as an example
/**
* @example
* thing.method(callback);
*
* @example <caption>If the callback is omitted, we'll return a Promise
* in its place.</caption>
* thing.method().catch(err => {});
*/
Results in something like this
<caption>If the callback is omitted, we'll return a Promise
in its place</caption>
thing.method().catch(err => {});