oasis-tcs / tosca-specs

OASIS TOSCA TC: This repository contains drafts of the TOSCA TC’s specifications and committee notes. https://github.com/oasis-tcs/tosca-specs
Other
5 stars 5 forks source link

Mermaid drawings not rendered #64

Open lauwers opened 2 months ago

lauwers commented 2 months ago

Mermaid drawings in the TOSCA v2.0 Markdown file are not rendered when converting to Word, HTML, or PDF. Assuming Pandoc was used for this conversion, a special-purpose filter is needed by Pandoc to recognized Mermaid drawings. It turns out there is NodeJS package called mermaid-filter that will do the trick:

https://github.com/raghur/mermaid-filter

On Windows, I ran it as follows:

pandoc -f gfm -t docx -F mermaid-filter.cmd -o TOSCA-v2.0.docx TOSCA-v2.0.md

It requires NodeJS and npm on the machine on which it is run.