Как в jsdoc можно оставить комментарий для frontatter, который преобразуется без изменений в markdown?
В проекте я использую jsdoc и vuepress
README.md для config -а в vuepress собирается из jsdoc
Комманда преобразования jsdoc to markdown
jsdoc2md --files server_book.js > docs/vuepress/src/src/config/README.md
example:
jsdoc
/**
* Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sodales ut est eu varius. Vivamus imperdiet aliquet risus, vel tincidunt massa sagittis nec. In magna massa, maximus sit amet lectus id, venenatis viverra felis. Ut molestie nisl in mauris scelerisque, non hendrerit lacus gravida.
* @module App
* @memberof words
*/
/**
* A namespace.
* @namespace words
* @description <demo-component
* title="jsDoc"
* />
* ::: details
* Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sodales ut est eu varius. Vivamus imperdiet aliquet risus, vel tincidunt massa sagittis nec. In magna massa, maximus sit amet lectus id, venenatis viverra felis. Ut molestie nisl in mauris scelerisque, non hendrerit lacus gravida. Donec commodo ipsum nec luctus facilisis. Praesent rutrum tincidunt mauris, id sollicitudin odio sollicitudin in. Fusce libero lacus, gravida ultricies sollicitudin eget, pulvinar sit amet purus. Nulla facilisi. Quisque metus enim, scelerisque sed dictum ut, mollis vel magna. Ut eleifend, nibh id sollicitudin laoreet, justo est tincidunt nunc, in blandit justo velit placerat purus. Aenean at imperdiet nisi. Integer sagittis leo ligula, vitae suscipit est cursus nec.
* :::
*
* 
*
*/
Markdown файл который получается
<a name="words.module_App"></a>
## App
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sodales ut est eu varius. Vivamus imperdiet aliquet risus, vel tincidunt massa sagittis nec. In magna massa, maximus sit amet lectus id, venenatis viverra felis. Ut molestie nisl in mauris scelerisque, non hendrerit lacus gravida.
<a name="words.module_App..words"></a>
### App~words : <code>object</code>
<demo-component
title="jsDoc"
/>
::: details
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sodales ut est eu varius. Vivamus imperdiet aliquet risus, vel tincidunt massa sagittis nec. In magna massa, maximus sit amet lectus id, venenatis viverra felis. Ut molestie nisl in mauris scelerisque, non hendrerit lacus gravida. Donec commodo ipsum nec luctus facilisis. Praesent rutrum tincidunt mauris, id sollicitudin odio sollicitudin in. Fusce libero lacus, gravida ultricies sollicitudin eget, pulvinar sit amet purus. Nulla facilisi. Quisque metus enim, scelerisque sed dictum ut, mollis vel magna. Ut eleifend, nibh id sollicitudin laoreet, justo est tincidunt nunc, in blandit justo velit placerat purus. Aenean at imperdiet nisi. Integer sagittis leo ligula, vitae suscipit est cursus nec.
:::

**Kind**: inner namespace of [<code>App</code>](#words.module_App)
Для того, что бы frontmatter увидел переменные надо что бы в генерируемом markdown строка для него стояла первой в генерируемом файле.
Пример:
---
frontmatter: frontmatter property
---
После преобразования должен получиться такой markdown файл
---
frontmatter: frontmatter propery
---
<a name="words.module_App"></a>
## App
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi sodales ut est eu varius. Vivamus imperdiet aliquet risus, vel tincidunt massa sagittis nec. In magna massa, maximus sit amet lectus id, venenatis viverra felis. Ut molestie nisl in mauris scelerisque, non hendrerit lacus gravida.
......