再不用怕 Markdown 中的绘图了,GitHub 官方支持 Mermaid 图表绘制工具
开发人员已能够在 GitHub 中使用 Mermaid 图表工具。Mermaid 作为图表绘制工具越来越多的受到开发人员的欢迎。它基于 Javascript ,通过解析类 Markdown 的文本语法来实现图表的创建和动态修改,可以使用这个工具来进行包括流程图,时序图等图表的绘制。可以将其看做是 Markdown 的一个插件。
文章图片
截至目前,用户想要在 GitHub 上的 Markdown 文件中包含图片 / 图表,唯一的做法是通过嵌入图像来实现。目前 Mermaid 由 Knut Sveidqvist 进行维护。
文章图片
新的一年,GitHub 开发者关系总监 Martin Woodward 在官方博客表示,从现在开始,用户可以通过 GitHub 体验到一项原生功能 —— 支持基于 JavaScript 的 Mermaid 图表和流程图生成工具。
现在用户通过使用 Mermaid 语法就可以创建内联图,例如:
文章图片
上面的原始代码块在渲染后,在 Markdown 中显示如图:
文章图片
当代码遇到标记为 mermaid 的代码块时,会生成一个 iframe,iframe 采用原始 Mermaid 语法并传递给 Mermaid.js,然后将代码转换为本地浏览器中的图表。实现这一过程需要如下两个阶段:
- GitHub 的 HTML pipeline;
- 内部文件渲染服务。
接下来,假设用户是在支持 JavaScript 的环境中查看内容,此时会将 iframe 添加到页面,将 src 属性指向 Viewscreen 服务。这样做具有以下优点:
- 将库 offload 到外部服务时,可以减少 JavaScript 有效负荷;
- 异步渲染图表有助于消除开销;
- 用户提供的内容被锁定在 iframe 中,这样不会在加载图表的 GitHub 页面上造成破坏。
下面是 Mermaid pipeline 可视化路径图:用户可以得到一个快速的、易于编辑的和基于矢量的图,它会出现在文档中需要的地方。
文章图片
想了解更多有关 Mermaid 语法的信息,请参考:
http://mermaid-js.github.io/m...
参考链接:
【再不用怕 Markdown 中的绘图了,GitHub 官方支持 Mermaid 图表绘制工具】https://github.blog/2022-02-1...
来源:机器之心开源前哨
日常分享热门、有趣和实用的开源项目。参与维护 10万+ Star 的开源技术资源库,包括:Python、Java、C/C++、Go、JS、CSS、Node.js、PHP、.NET 等。
推荐阅读
- python|Pycharm配置虚拟环境及安装库
- OpenCV|Visual Studio 2022下载及配置OpenCV4.5.5
- python|10 款最好的 Python IDE(十)
- 其他|关于IDE、调试技巧与编码幸福感
- C语言|vscode配置C语言环境
- pycharm|【Python实现视频转文字操作】
- java|JetBrains IDE/Android Studio 翻译插件,支持中英互译、单词朗读。
- visual|微软集成开发者工具到 Visual Studio 中,工具迎来“大换血”()
- IDEA破解方法,永久激活