omits empty comments and code lines (above and below)
removes extra padding above and below the code block areas, which looked accidental and annoying
two lines of comments next to each other will become one line (a paragraph) in markdown rendering, but two lines with a line-break between will remain two lines in markdown rendering (two paragraphs). this was not happening before.
...and my language file, for anyone else who also likes to mix use JSDocs with Docco:
For an example, I like to do my JSDocs like this, so they work in Markdown, as well as IDE:
/**
* ### _id(t)
* Required by all MongoDB documents,
* and is a type of `ObjectId` from its own collection.
*
* type + name | description
* ---|---
* @param {string} t - | Name of model.
* @returns {object} - | Instance of validation rule.
*/
COMMON_SCHEMA._id = t => field().objectId(t);
I suggest everyone would benefit from this being the new
plain-markdown.jst
template going forward:Rationale:
...and my language file, for anyone else who also likes to mix use JSDocs with Docco:
For an example, I like to do my JSDocs like this, so they work in Markdown, as well as IDE:
Currently invoking like:
Sorry, was too lazy to fork and PR this.