You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在GitLab的README.md中直接渲染项目内的.excalidraw文件?

GitLab渲染独立.excalidraw文件的可行方案
  • GitLab 16.0及以上版本已经原生支持独立.excalidraw文件的直接渲染:你只需要将myFigure.excalidraw添加到项目仓库的任意路径,点击该文件即可查看渲染完成的可视化图表,无需将代码复制到README.md中。
  • 你所提到的通过代码块直接引用.excalidraw文件路径、在README中直接渲染的写法,目前GitLab原生暂不支持,可通过以下两种方案实现类似效果:

方案1:静态图关联源文件(适配所有版本GitLab)

将Excalidraw图表导出为PNG或SVG格式,和.excalidraw源文件一起存入仓库,README中插入静态图,同时补充源文件的跳转入口即可,示例写法:

![功能架构图](./myFigure.svg)
*[编辑该Excalidraw源文件](./myFigure.excalidraw)*

该方案不会在README中插入冗余的Excalidraw代码,同时保留了图表的可编辑入口。

方案2:安装渲染扩展(仅适配自托管GitLab)

如果你使用的是自托管GitLab实例,可以安装社区提供的Excalidraw渲染扩展,完成配置后即可支持直接通过路径引用的方式在Markdown中渲染图表,示例写法:

```excalidraw
path: myFigure.excalidraw
目前GitLab公有云版本还未上线该路径引用渲染能力,需等待后续版本迭代支持。

内容的提问来源于stack exchange,提问作者hermanjakobsen
相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.01 10:45:01