Markdown Test
Markdown syntax reference
- Published
- 24 March 2026
- Read time
- 4 min read
Was this useful?
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
- Marker character change forces new list start:
- Very easy!
Ordered
- Lorem ipsum dolor sit amet
- Consectetur adipiscing elit
- Integer molestie lorem at massa
Start numbering with offset:
- foo
- bar
Code
Inline code
Fenced, no language:
Sample text here...Fenced, with language and title:
var foo = function (bar) { return bar++;};
console.log(foo(5));Fenced, shell:
pnpm install && pnpm devTables
| Option | Description |
|---|---|
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |
Right aligned columns:
| Option | Description |
|---|---|
| data | path to data files to supply the data that will be passed into templates. |
| engine | engine to be used for processing templates. Handlebars is the default. |
| ext | extension to be used for dest files. |
Links
Images
Co-located image (relative path, same folder as the post):

External image (absolute URL):
![]()
Emoji
Shortcodes:
| Source | Rendered |
|---|---|
:rocket: | 🚀 |
:tada: | 🎉 |
:sparkles: | ✨ |
:white_check_mark: | ✅ |
Emoticons:
| Source | Rendered |
|---|---|
:-) | 😃 |
:-( | 😦 |
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)
- H
2O (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
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
If this has been useful, you can back the writing with a one-off tip through a secure Stripe checkout.
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.
Comments
Loading comments…
Leave a comment