Markdown Style Guide

Introduction

This page is a style guide. It exists to test the visual appearance of all standard Markdown elements. Below, you will find typography, lists, code, tables, and media.


Typography

Headings

Heading Level 1

Heading Level 2

Heading Level 3

Heading Level 4

Heading Level 5
Heading Level 6

Text Formatting

You can make text bold, italic, or bold and italic.

You can also use strikethrough to indicate deleted text.

Blockquotes

This is a blockquote. It is often used to highlight important information or quote external sources.

It can also be nested.


Lists

Unordered List

  • Item one
  • Item two
    • Nested item A
    • Nested item B
  • Item three

Ordered List

  1. First step
  2. Second step
  3. Third step

Task List

  • [x] Create the blog
  • [x] Write the first post
  • [ ] Style the CSS

Code

Inline Code

You can format code appearing within a paragraph, like npm install @11ty/eleventy, using backticks.

Code Blocks

Here is a block of JavaScript code:

const greet = (name) => {
  console.log(`Hello, ${name}!`);
};

greet('World');

Here is some CSS:

body {
  background-color: #1a1a1a;
  color: #ffffff;
}

Media

Images

Here is a sample image with alt text and a title.

A placeholder image of a mountain landscape

Figure: This is a caption for the image above.

Standard Image

A beautiful mountain landscape

Linked Image (Clickable)

Click to visit Google

Image with Caption

Abstract Art

Figure 1: An example of abstract placeholder art.

HTML Image (sized to 200px wide)

Small Red Box

Media Gallery

Fluid Image

Wide banner image

Linked Image

Click this banner

Image Grid (Using HTML)

Square 1 Square 2 Square 3

Lightbox

Orange Red Blue Grey Green Purple

Links

Here is a link to Eleventy's Documentation.


Tables

Tables are great for structured data.

Feature Support Notes
Markdown Yes Standard content format
Nunjucks Yes Templating engine
SCSS Optional Requires build step

YouTube Videos

Or just the URL without a title:


GitHub Gists

Option 1: Embed the whole Gist

Option 2: Embed a specific file from a Gist (Useful if a Gist contains multiple files)


Google Slides

Other Elements

Horizontal Rules

Separators can be created with three dashes: