Markdown 101 · Part 6/10
Before publishing a Markdown draft from Obsidian to Hugo, review the content against a short checklist, preview the rendered HTML locally with hugo server, and verify the live URL after deployment. The blog commands below are part of Dyn’s custom workflow.
Pre-Publish Quality Checklist
- Direct opening: Do the first 1–2 sentences answer the reader’s main question?
- Heading hierarchy: Exactly one
H1(from the post title), with##and###in logical order. - Complete YAML: Unique
Mô tả, lowercase hyphenatedSlug,Chuyên mục, andtags. - Clean Markdown: Closed code fences, meaningful image
alttext, and zero local drive paths.
Preview Locally With Hugo
Run the preview server in your Terminal (or click Preview in blog ui):
blog preview
This builds a local preview—including drafts—at http://127.0.0.1:1313. Because Obsidian-specific syntax (such as wikilinks) renders differently on the web, always use standard Markdown links for public navigation.
Publish to GitHub Pages
Before publishing, verify Ngày xuất bản in YAML (if blank, the converter falls back to Ngày tạo), then run:
blog publish "markdown-101-01-getting-started"
The script converts the Obsidian note into a Hugo bundle, verifies the build with hugo --gc --minify, commits, and pushes to GitHub. Keep unfinished parts in draft status and only add links to parts that are already live.
Post-Deploy Verification
- Open the live URL on
cmduyeen.github.ioand check layout, code blocks, and images on both desktop and mobile. - Click every internal link and reference link.
- Confirm the post appears in Archive and
/en/sitemap.xml. - If your domain is verified in Google Search Console, run URL Inspection to check indexing status.
Practice Now
Fix the draft snippet below: add a space after ##, remove the filler intro, and turn the checklist items into a bulleted list.
Practice Now
Fix the heading syntax, remove the filler sentence, and format the last three lines as a bulleted list.
Show hint
Add a space after ##. Prefix each checklist item with - and a space.
Runs locally in your browser (nothing is uploaded or auto-saved). Supports headings, paragraphs, lists, checklists, tables, blockquotes, code, emphasis, links, and local site images.
Source: Hugo Content Management.
In the Markdown 101 series:
- Part 01: What Is Markdown and How to Create Your First .md File
- Part 02: How to Write Headings, Paragraphs, and Emphasis in Markdown
- Part 03: How to Write Lists, Blockquotes, and Code Blocks in Markdown
- Part 04: How to Add Links and SEO-Friendly Images in Markdown
- Part 05: Minimal Markdown Post Template and YAML Front Matter for Blogs
- Part 06: How to Preview and Publish Markdown Posts to Hugo on GitHub Pages (reading)
- Part 07: How to Create Tables and Horizontal Rules in Markdown
- Part 08: How to Write Checklists, Footnotes, and Escaped Characters in Markdown
- Part 09: How to Use Obsidian Callouts and Wikilinks and Export Cleanly to Hugo
- Part 10: Capstone Practice - Write a Complete Markdown Article from Scratch
Loading comments...