One-off tip

Support checkout

  1. 1 Choose amount
  2. 2 Payment
  3. 3 Thank you

Choose amount

Pick the level of support that feels right. You can keep it simple or enter a custom amount, then continue to secure payment.

Choose a one-off amount
Markdown Test
Cover image: Colourful code on a screen — Photo by Chris Ried on Unsplash
astro blogging learning in public

Markdown Test

Markdown syntax reference

Published
24 March 2026
Read time
4 min read

This is not a real article. It exists purely to test how Markdown renders in blog posts on this site — headings, emphasis, lists, code blocks, tables, blockquotes, and everything else.

Headings

h1 Heading

h2 Heading

h3 Heading

h4 Heading

h5 Heading
h6 Heading

Horizontal Rules




Emphasis

This is bold text

This is italic text

Strikethrough

Blockquotes

Blockquotes can also be nested…

…by using additional greater-than signs right next to each other…

…or with spaces between arrows.

Lists

Unordered

  • Create a list by starting a line with +, -, or *
  • Sub-lists are made by indenting 2 spaces:
    • Marker character change forces new list start:
      • Ac tristique libero volutpat at
      • Facilisis in pretium nisl aliquet
      • Nulla volutpat aliquam velit
  • Very easy!

Ordered

  1. Lorem ipsum dolor sit amet
  2. Consectetur adipiscing elit
  3. Integer molestie lorem at massa

Start numbering with offset:

  1. foo
  2. bar

Code

Inline code

Fenced, no language:

Sample text here...

Fenced, with language and title:

example.js
var foo = function (bar) {
return bar++;
};
console.log(foo(5));

Fenced, shell:

Terminal window
pnpm install && pnpm dev

Tables

OptionDescription
datapath to data files to supply the data that will be passed into templates.
engineengine to be used for processing templates. Handlebars is the default.
extextension to be used for dest files.

Right aligned columns:

OptionDescription
datapath to data files to supply the data that will be passed into templates.
engineengine to be used for processing templates. Handlebars is the default.
extextension to be used for dest files.

Link text

Link with title

Images

Co-located image (relative path, same folder as the post):

Colourful code on a screen

External image (absolute URL):

Astro logo

Emoji

Shortcodes:

SourceRendered
:rocket:🚀
:tada:🎉
:sparkles:
:white_check_mark:

Emoticons:

SourceRendered
:-)😃
:-(😦
8-)😎
;)😉

Mermaid Diagrams

Inline HTML

Date chip — source: <span class="date-chip">1 April</span>

Rendered: 1 April

Footnotes

Here is a sentence with a footnote.1

And another with a second one.2

Not currently supported

The following features are not enabled in this setup. They are documented here for reference and may be added in a future update.

Typographic replacements

The typographer option (smart quotes, -- em-dashes, (c) → ©) is not enabled. These render as literal characters:

(c) (r) (tm) — ---

“Double quotes” and ‘single quotes’ are not smart-quoted.

Subscript / Superscript

Requires markdown-it-sub / markdown-it-sup. Not installed.

  • 19^th^ (superscript — renders as literal)
  • H2O (subscript — renders as literal)

Inserted text

Requires markdown-it-ins. Not installed.

++Inserted text++ (renders as literal)

Marked / highlighted text

Requires markdown-it-mark. Not installed.

==Marked text== (renders as literal)

Definition lists

Requires markdown-it-deflist. Not installed.

Term 1 : Definition 1

Abbreviations

Requires markdown-it-abbr. Not installed.

*[HTML]: Hyper Text Markup Language

Custom containers

Requires markdown-it-container. Not installed.

::: warning here be dragons :::

Footnotes

  1. This is the first footnote.

  2. This is the second footnote, with bold and code.

Working on something similar?

Need help raising the bar?

I help teams improve engineering practice through hands-on delivery, pragmatic reviews, and mentoring. If you want a second pair of eyes or practical support, let's talk.

  • Engineering practice review
  • Hands-on delivery
  • Team mentoring
Get guidance

If this has been useful, you can back the writing with a one-off tip through a secure Stripe checkout.

Comments

Loading comments…

Leave a comment

Free · Practical · One email per post

Get practical engineering notes

One short email when a new article goes live. Useful if you are breaking into tech, growing as an engineer, or improving engineering practice on your team.