Include diagrams in your Markdown files with Mermaid
1–10 of 272 posts
Re: Include diagrams in your Markdown files with Mermaid
#2nicely seen[1] on their roadmap a month ago.
not github specific but i really enjoyed this quite long post/tutorial on realtime collaboration with mermaid (using notion)[2].
[1] https://github.com/github/roadmap/issues/372 https://news.ycombinator.com/item?id=29927962 (72 points, 14 comments, 31 days ago)
[2] https://www.happyandeffective.com/blog/realtime-collaborativ... https://news.ycombinator.com/item?id=30238208 (12 points, 2 comments, 7 days ago
Re: Include diagrams in your Markdown files with Mermaid
#3[deleted]
Re: Include diagrams in your Markdown files with Mermaid
#4[deleted]
Re: Include diagrams in your Markdown files with Mermaid
#5This can be done with Bitbucket but the existing marketplace plug-in has been broken since they added the connect/disconnect webhooks as mandatory. Of course, the plug-in is provided by bitbucket …so that’s fun.
I wrote a trivial webstack to answer 200 to the webhook and then everything works. (Don’t know if I can publish it unfortunately.)
(Condolences to those stuck on Bitbucket).
Re: Include diagrams in your Markdown files with Mermaid
#6Huh, they must have taken the integration they've had for a couple years now on the Azure Devops wikis and shifted it over to the GitHub side.
Re: Include diagrams in your Markdown files with Mermaid
#7Thereby creating a hard dependency for your markdown files, obviating their portability.
Re: Include diagrams in your Markdown files with Mermaid
#8Thereby creating a hard dependency for your markdown files, obviating their portability.
There's no hard dependency at all. The markdown will parse just fine without mermaid.js, it basically just takes a code block and runs it through the mermaid.js code if it matches the language
Re: Include diagrams in your Markdown files with Mermaid
#9I’m super excited for this!
One thought though, on the syntax. Wouldn’t it be a bit odd if suddenly this line in a README.md:
```js
const foo = 1 + 1
```
`2`
Re: Include diagrams in your Markdown files with Mermaid
#10Do they support a markdown Table of Contents yet?