https://liquid-stack.pages.dev/tags/writing/Recent content in Writing on Liquid StackHugo -- gohugo.ioen-USMy BlogThu, 23 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/p/writing-markdown-and-bilingual-posts/Thu, 23 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/p/writing-markdown-and-bilingual-posts/<p>Liquid Stack uses Hugo’s multilingual content structure: Chinese and English versions of one post live in the same directory.</p> <h2 id="create-a-post-directory">Create a post directory </h2><p>Create <code>index.md</code> and <code>index.zh.md</code> under <code>content/post/your-slug/</code>. Give both files the same <code>slug</code> so the language switcher recognises them as translations of one post.</p> <h2 id="write-useful-front-matter">Write useful front matter </h2><p>Every post should have a title, description, date, category, and tags. Localise the title and description for each audience rather than translating word by word; keep product names, commands, and code unchanged.</p> <h2 id="keep-it-maintainable">Keep it maintainable </h2><p>Store images in <code>static/img/your-slug/</code> and use site-absolute paths such as <code>/img/your-slug/featured.png</code>. Before release, check links, images, and categories in both languages.</p>