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

如何在Jekyll中读取MD文件并调用其变量?

解决Jekyll调用指定文件YAML变量的问题

错误根源

你直接把文件路径字符串赋值给my_variable,Jekyll不会自动将这个字符串解析为包含YAML前端信息的文档对象,因此无法通过.image调用该文件的YAML变量。

解决步骤

1. 确认自定义集合配置(必做)

因为你的文件存放在_nearby文件夹下,这属于Jekyll的自定义集合,需要先在_config.yml中配置该集合:

collections:
  nearby:
    output: false # 不需要生成独立页面可设为false,需要则设为true

配置后重启Jekyll服务,让配置生效。

2. 正确引用文档并调用变量

有两种可行的方式:

方式一:在页面YAML前端定义变量

在需要调用的页面的YAML前端添加:

my_variable: "{{ site.nearby | where: 'path', '2022-10-03-ancient-places.md' | first }}"

然后在页面正文中调用变量:

{{ my_variable.image }}

方式二:直接在Liquid模板中查找调用

无需在YAML中定义变量,直接在页面正文里写Liquid代码:

{% assign target_doc = site.nearby | where: 'path', '2022-10-03-ancient-places.md' | first %}
{{ target_doc.image }}

注意事项

  • path参数的值是相对于集合文件夹_nearby的路径,所以只需要写2022-10-03-ancient-places.md,不要带nearby/前缀。
  • 如果_nearby文件夹下有子目录,路径需要包含子目录部分,比如文件在_nearby/cities/xxx.md,则path写cities/xxx.md。

内容的提问来源于stack exchange,提问作者Shiv Singh

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.18 01:10:32