https://liquid-stack.pages.dev/tags/markdown/Recent content in Markdown on Liquid StackHugo -- gohugo.ioen-USMy BlogFri, 24 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/p/using-shortcodes/Fri, 24 Jul 2026 00:00:00 +0000https://liquid-stack.pages.dev/p/using-shortcodes/<p>Shortcodes are Hugo’s way to insert reusable structures into Markdown, making them useful for callouts, embeds, and repeated layouts.</p> <h2 id="start-with-existing-shortcodes">Start with existing Shortcodes </h2><p>Browse <code>layouts/shortcodes/</code> to see what the theme already provides. Reuse existing components before adding one-off HTML for a single article.</p> <h2 id="when-to-use-one">When to use one </h2><p>Use a Shortcode when content needs a fixed structure, recurs across posts, or must render as HTML. Keep ordinary paragraphs, lists, and code blocks in Markdown.</p> <h2 id="test-the-result">Test the result </h2><p>Preview the post on desktop and mobile after adding a Shortcode. If it uses an image, video, or external URL, check the resource path and its failure state too.</p>https://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>