如何在Markdown与GitHub中正常展示assets目录下的.ofig格式图片
问题核心原因
.ofig是Origin软件的专属工程图格式,仅支持在Origin软件或安装了对应解析插件的特定环境中打开。普通Markdown预览工具、GitHub的Markdown渲染引擎均原生不支持该格式的解析渲染,你尝试的几种路径写法本身没有错误,无法加载的核心原因为格式不兼容。
可行解决方案
方案1:转换为通用图片格式(最推荐,全场景适配)
这是唯一可以同时满足本地预览、GitHub公开正常显示的方案:
- 用Origin软件打开对应.ofig源文件
- 选择导出功能,将文件导出为PNG、JPG、SVG这类通用图片格式,其中SVG为矢量格式,适配技术类图表的缩放需求,不会出现失真问题
- 将导出后的文件存入assets目录,使用你之前尝试的任意一种正确路径写法即可正常加载,示例:
 <!-- 或自定义尺寸的img写法 --> <img src="./assets/SIR-figure-1.png" width="auto" height="auto" />
方案2:本地安装解析插件(仅适合本地自用场景)
如果仅需要在本地环境预览,不需要推送至GitHub公开分享,可以给使用的Markdown编辑器安装对应.ofig预览插件:
- 例如VS Code可在插件市场搜索Origin相关预览插件,安装后即可在本地编辑器内识别.ofig格式图片
- 该方案仅本地生效,推送至GitHub或发送给其他未安装对应插件的用户时,依然无法正常显示
不推荐强行直接使用.ofig格式插入Markdown,没有通用渲染支持的前提下,无论怎么调整路径都无法实现全场景正常显示。
内容的提问来源于stack exchange,提问作者Dušan Stokić
相关产品推荐
相关产品推荐

