fralau / mkdocs-macros-plugin

Create richer and more beautiful pages in MkDocs, by using variables and calls to macros in the markdown code.
https://mkdocs-macros-plugin.readthedocs.io
Other
327 stars 51 forks source link

Mermaid seems to be incompatible with mkdocs-macros #225

Closed SPyofgame closed 2 months ago

SPyofgame commented 5 months ago

With mermaid.js and html, css inside the table, I can make some visualization like this

image

But after using mkdocs-macros, I can still you mermaid.js but I can not name any nodes nor using CSS

image

github-actions[bot] commented 5 months ago

Welcome to this project and thank you!' first issue

SPyofgame commented 5 months ago

Fixed, by doing something like

      j2_block_start_string: '{{{%'
      j2_block_end_string: '%}}}'
      j2_variable_start_string: '{{{@'
      j2_variable_end_string: '}}}@'
      j2_comment_start_string: '{{{#'
      j2_comment_end_string: '#}}}'
fralau commented 5 months ago

Wow, what a pretty diagram!

For our information did you identify the piece of code in Mermaid that was tripping MkDocs-Macros?

SPyofgame200 commented 5 months ago

I don't know for sure, but I think some kind of start_string and end_string of mermaid and macros was incompatible so we must use them differently. I tried to change a few permutations of order of the plugins but it seems... ehmmmm not working I guess ?

SPyofgame200 commented 5 months ago

Wow, what a pretty diagram!

For our information did you identify the piece of code in Mermaid that was tripping MkDocs-Macros?

I was dedicated with my own project, in order to teach my students better, so I tried to make my site with many interactive features

fralau commented 5 months ago

Perhaps searching with your editor for offending strings might help?

I am just curious about it: the question of how to ensure compatibility of Mkdocs-Macros' syntax with other plugins has been a topic of extensive research.

And considering that I am the author of both plugins 🙂 ...