Markdown 101 · Part 4/10
Add links with [label](url) and images with . Good link labels describe the destination, and good alt text describes what the image shows for both accessibility and search engines.
Descriptive Links and Internal Paths
Read the [CommonMark syntax reference](https://commonmark.org/help/).
“CommonMark syntax reference” tells readers where the link leads—far better than vague labels like “click here”.
Common link patterns for blogs:
- External link: full URL
https://.... - Internal post link: root-relative path, such as
[Part 1: Getting Started](/posts/markdown-101-01-getting-started/). - Same-page anchor link:
[Section Name](#section-name)using lowercase letters and hyphens. - Hover title:
[label](https://... "Short tooltip").
Adding Images With Meaningful Alt Text

Include images when they clarify a workflow or diagram. The text inside [] (alt text) appears if the image fails to load and helps screen readers and search engines understand the visual—avoid generic names like image1 or screenshot.png.
In Dyn’s Obsidian-to-Hugo workflow, images placed next to the note or in Tệp đính kèm/ are copied automatically into the Hugo post bundle on publish.
Avoid Local Drive Paths
Never reference local filesystem paths such as D:\Brain2nd\... in public articles—readers on the web cannot access files on your machine. Use short, lowercase, hyphenated filenames (e.g., markdown-cheat-sheet.png) and verify every image in Hugo preview before publishing.
Practice Now
Replace the generic link label and image alt text below with clear, descriptive wording.
Practice Now
Change the link label to a clear resource name and replace the image alt text with what the icon represents.
Show hint
Keep the URL inside parentheses. Update the text inside square brackets; images keep the leading !.
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: CommonMark Links & Images.
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 (reading)
- 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
- 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...