Skip to content
Armen Deroian / Articles
Search articles

Markdown Reference: Tables, Footnotes, and Images

A demonstration of the everyday Markdown elements this site supports, including lists, tables, block quotes, images, footnotes, and external links.

Published Updated 1 min readCategory: Site Notes

Demonstration content. This page is a rendering reference for the site’s Markdown styles.

This article lives in its own folder (markdown-reference/index.md) so that its image can sit next to it. Its URL comes from the folder name.

Text formatting

Paragraphs support strong emphasis, emphasis, strikethrough, inline code, and keyboard shortcuts such as Ctrl + K. Straight quotes become “curly quotes”, and two hyphens become an en dash — like this.

Lists

  1. Ordered lists keep their numbering.
  2. They can contain nested lists:
    • Unordered items use bullets.
    • Nesting works to any depth.
  3. And they can continue afterwards.
  • Task lists render checkboxes.
  • Unchecked items are shown too.

Block quotes

A block quote is set off from the surrounding text with a rule on its left.

It can span multiple paragraphs.

Tables

Wide tables scroll horizontally inside their own region, so they never widen the page:

LanguageTypical file extensionParadigmMemory managementTypical use in this site’s articles
C.c, .hProceduralManualLow-level examples
C++.cpp, .hppMulti-paradigmManual and RAIISystems and graphics examples
Rust.rsMulti-paradigmOwnership and borrowingSystems examples
TypeScript.tsMulti-paradigm, statically typedGarbage collectedTooling and web examples

Images

Images placed next to an article are optimized at build time and served in modern formats:

A five-stage pipeline: Markdown, Validate, Render, Index, Deploy, connected left to right by arrows.

Footnotes and references

Footnotes collect at the end of the article1, and each one links back to where it was referenced2. Links to other sites, like the CommonMark specification (external link), are marked as external.


Horizontal rules, like the one above, separate sections without adding a heading.

Footnotes

  1. Footnotes use the GitHub-flavored Markdown syntax: [^label] in the text and [^label]: text anywhere in the document. ↩