-
Notifications
You must be signed in to change notification settings - Fork 96
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Enable myst-parser mermaid rendering without curly braces in markdown #99
Comments
I agree, this would indeed be useful to have! It would make collaborating and reviewing/discussing PRs much more streamlined if the mermaid diagrams were rendered in the PR files/diff view, and I think using the brace-less syntax should achieve that. Right now we can either open parallel issues where we copy/paste diagrams, or render the whole documentation and inspect that. |
+1 to this feature, would be a great improvement! |
+1 to this feature. |
Note executablebooks/MyST-Parser#366 has been fixed by executablebooks/MyST-Parser#742 which I believe also fixes this issue. |
rendering between Sphinx and GitHub. Refs: mgaitan/sphinxcontrib-mermaid#108 mgaitan/sphinxcontrib-mermaid#99
+1 to this, would also like to see ::: mermaid |
The original ask can be done with |
closing as won't fix since the above works |
Thank you for the great work within this project! In working with mermaid diagrams through this extension and myst-parser within markdown files I've noticed a minor detail which might assist developers as they draft or review content.
When using this extension via myst-parser in markdown files, one is required to use the following format:
Some editors and interfaces, such as Github (see here), enable the rendering of mermaid without building it Sphinx. This format relies on a similar codeblock that does not use curly braces, as seen below:
Using a format which does not rely on curly braces would allow developers referencing mermaid content on platforms like Github to easily view both the rendered output and the code which rendered the output. Is this something which is possible through additional configuration or code with this extension? Thank you in advance for your thoughts and feedback on this topic.
Please note: I was unsure whether it'd be more appropriate to open an issue here or with the myst-parser project. Please don't hesitate to let me know if I may reference this topic elsewhere, or upvote an existing issue, thank you!
The text was updated successfully, but these errors were encountered: