Jekyll Multilingual Permalinks

Placing articles in en/ and zh/ subdirectories, does not affect the permalink set. As long as explicitly define permalink: in the Front Matter, Jekyll will generate HTML based on it, regardless of file location.

Notes

  • It is recommended to include a complete permalink: in every post.
  • en/ and zh/ are for content organization only and do not affect the URL.
  • If permalink: is not set, Jekyll will fall back to the default format in _config.yml, which may be affected by folder and filename.

_posts/en/utopia.md

---
lang: en
title: Utopia
permalink: /blog/2025-07-30/utopia/
---

_posts/zh/utopia.md

---
lang: zh
title: 乌托邦
permalink: /zh/blog/2025-07-30/utopia/
---