Post

Markdown Links Syntax

Syntax for local / web links in markdown

Mardown Links

The syntax for a web link is [text](url)

  • [Google](https://www.google.co.uk) shows Google

The syntax for a local file link is [text](relative path) using ./ for the local directory

  • [Node](./2025-05-12-node.md) shows Node
  • [Node](2025-05-12-node.md) shows Node
  • [Node](/_posts/2025-05-12-node.md) shows Node

Jekyll Links

The syntax for linking to another post involves omitting the extension for the filename, as it will not be a markdown file when the site is generated, you also omit the date.

The links below don’t seem to form working links on the built site

This syntax, however, seems to work

This post is licensed under CC BY 4.0 by the author.