Skip to content

Writing with content blocks: lists, tables, notes, galleries and video

A tour of the building blocks behind every product page and blog post on this site, with live examples and the Markdown that produces them.

By Egor Danilov

Spicanet

Product pages, legal pages and blog posts on spicanet.net are all written in Markdown with a few extra content blocks. This post shows each one, with the source underneath.

Lists and tables

  • Unordered lists
  • With nested items
  • Like this
  1. Ordered lists
  2. For sequences
Block Use it for
Table Comparing options
Note Context the reader should not miss
Steps A process in order
| Block | Use it for |
| --- | --- |
| Table | Comparing options |

Notes, tips, warnings

:::tip Optional title
Text with **Markdown** inside.
:::

Steps and checklists

  1. Write the draft.
  2. Preview it.
  3. Publish.
  • Done: Drafted
  • Done: Reviewed
  • To do: Published

Frequently asked questions

What are details blocks for?

Collapsing long answers so the page stays easy to scan.

Images, galleries and video

Images become captioned figures, galleries lay several images out in a grid, and video embeds support YouTube, Vimeo and direct video files.

![Alt text](/media/library/photo.jpg "Caption")

:::gallery 3
![One](/media/library/one.jpg "Caption")
![Two](/media/library/two.jpg "Caption")
:::

:::video https://www.youtube.com/watch?v=VIDEOID Title
Optional caption.
:::

Quotes and buttons

Short, quotable lines stand out from the body text.

A pull quote

Browse all products