Open michael-nok opened 11 months ago
Markdown tables require that we define them using three or more hyphens (---) to create each column’s header. Without three hyphens, certain systems will not interpret this information as a table (for example, DITA-OT transformation to PDF).
Table definition: https://www.markdownguide.org/extended-syntax/#tables
Sample source file: https://github.com/Neoteroi/mkdocs-plugins/blob/main/tests/res/swagger.json
Example command:
oad gen-docs -s json/swagger.json -d docs/swagger.md --style "MARKDOWN"
This is the current Markdown output when using --style "MARKDOWN"
--style "MARKDOWN"
### Cat | Name | Type | | -- | -- | // This is invalid | age | integer | | hunts | boolean |
However, it should in fact be the following:
### Cat | Name | Type | | --- | --- | // This is valid | age | integer | | hunts | boolean |
Hi @michael-nok Thank You for reporting this!
Markdown tables require that we define them using three or more hyphens (---) to create each column’s header. Without three hyphens, certain systems will not interpret this information as a table (for example, DITA-OT transformation to PDF).
Table definition: https://www.markdownguide.org/extended-syntax/#tables
Sample source file: https://github.com/Neoteroi/mkdocs-plugins/blob/main/tests/res/swagger.json
Example command:
This is the current Markdown output when using
--style "MARKDOWN"
However, it should in fact be the following: