Markdown Showcase

Markdown Showcase

Everything the theme renders: typography, alerts, tabs, tables, code, galleries, math, and diagrams.

#Markdown#Astro

Write plain Markdown; the theme handles the rest at build time. This post exercises everything it renders.

Typography#

Regular paragraphs with bold, italic, strikethrough, an inline link, inline code, and keyboard keys like Ctrl + K for search.

A plain blockquote: for quoted words, not for callouts.

A footnote reference1 sits at the end of a sentence.

Lists#

  1. Ordered items
  2. Count themselves

Alerts#

GitHub-style callouts, five kinds:

Note

Useful information that readers should know, even when skimming.

Tip

A helpful suggestion for doing something better.

Important

Key information required to achieve a goal.

Warning

Urgent info that needs immediate attention to avoid problems.

Caution

Advises about risks or negative outcomes.

Table#

SyntaxRenders as
**bold**bold
`code`code
~~strike~~strike

Code#

Fenced blocks go through Expressive Code — titles, line highlights, and copy buttons included:

src/example.ts
type ColorMode = 'light' | 'dark' | 'auto';
export function setMode(mode: ColorMode) {
document.documentElement.classList.toggle('dark', mode === 'dark');
}

Tabs#

Group alternatives with directives — four colons outside, three inside:

Terminal window
pnpm install

A single image stays a figure with a caption. Consecutive images become a gallery with a lightbox:

Math#

Inline math like E=mc2E = mc^2, and display math:

ex2dx=π\int_{-\infty}^{\infty} e^{-x^2} \, dx = \sqrt{\pi}

Diagrams#

flowchart LR A[Markdown] --> B[remark/rehype] B --> C[Astro components] C --> D[Static site]

Details#

Collapsed by default

Anything Markdown can render fits inside, including code and lists.


A horizontal rule closes the show.

Footnotes#

  1. And its note collects at the bottom of the page.

License

CC BY-NC-SA 4.0 This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Related Posts