Problems with mermaid graphs
Hi i'm using the mermaid extension to generate graphs, but when i export the pages on pdf, the graphs are not shown in the pdf. It's possible to solve the issue in any way?
-
Hi Gabriele Allegria, thanks for the post. Which app were you using for the Mermaid charts (there are quite a few offering this functionality)?
Depending on how the vendors of the respective macros you're using present this content to Confluence will determine if we can preserve the content in the export. For instance, some apps don't provide an export mode for their macro content or alternatively, use an integration pattern that requires a full-blown browser with all its session handling and frame composition features.
For the former, we often require vendors to follow the steps here to provide a compatible export mode that we can use. For the latter, we cannot support this integration type, as our Exporters will not process JavaScript, and thus the content will not be preserved. This is also the reason why such content is not supported by the built-in exporters in Confluence. Have you checked if the content is preserved by the native Confluence PDF Exporter? If it isn't, this is likely the problem.
Should you wish you can generate a debug export and send this to help@k15t.com and we can further check to see if the content can be preserved. For instance, sometimes when diagram content comes from an external source, the specific domain needs to be set in the Allowlist settings on server/DC in order for it to be exported. I hope this information helps.
Cheers, Thomas (K15t)
-
Hi K15t Team,
I'm just experiencing the very same issue. We tried several mermaid chart apps from the Marketplace. One of our favorites is Mermaid Charts & Diagrams for Confluence by weweave UG (https://marketplace.atlassian.com/apps/1222572/mermaid-charts-diagrams-for-confluence?hosting=cloud&tab=overview).
Confluence's native PDF export does successfully export diagrams based on this app - too large by default, but this can be adjusted within the app macro. It would be awesome if your truly great PDF exporter was able to export these diagrams, too.
We've tried several other 'mermaid enablers', some of which can be properly exported with Scroll PDF. But most of them lack usability or other configuration options. Closing this particular gap would be a great productivity boost for us.
Thanks in advance!
Lutz.
-
Hey Lutz Hoeger, thanks for the post. After looking into this we can see that the Mermaid Charts & Diagrams for Confluence app only defines the macro output for the built-in PDF exporter but not for third-party exports, such as from our apps. This means our apps and other export apps in Confluence will not be able to preserve the content in the generated exports.
We would therefore recommend reaching out the Mermaid Charts & Diagrams app vendor to check if they are planning to expand the export functionality to third party apps in Confluence. In order to make the app compatible with our own Scroll Exporter apps, they would need to follow the documentation we have here.
Regards, Thomas (K15t)
Please sign in to leave a comment.
Comments
4 comments