Start Writing: Markdown and Bilingual Posts

Maintain Chinese and English articles as a matched pair of files.

Author: Liquid Stack

Source: https://liquid-stack.pages.dev/p/writing-markdown-and-bilingual-posts/

Liquid Stack uses Hugo’s multilingual content structure: Chinese and English versions of one post live in the same directory.

Create a post directory

Create index.md and index.zh.md under content/post/your-slug/. Give both files the same slug so the language switcher recognises them as translations of one post.

Write useful front matter

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.

Keep it maintainable

Store images in static/img/your-slug/ and use site-absolute paths such as /img/your-slug/featured.png. Before release, check links, images, and categories in both languages.

Was this article helpful?
  • Love it
  • Funny
  • Thought-provoking
  • Surprising
  • Sad
4 Comments
  • Latest
  • Oldest
  • Hottest
Alex 2 days ago

The homepage widgets feel complete and are ready once the sample content is replaced.

Liquid Stack Author 2 days ago

@Alex:

Thanks for trying it. The sample content, images, and links can all be replaced.

Momo 1 day ago

@Liquid Stack:

Switching between English and Chinese is smooth, and the page structure stays consistent.

Liquid Stack Author Just now

@Momo:

Comments, backlinks, and the CMS keep their complete entry points and work after connecting your own services.

Powered by Waline