Markdown Elements Reference

Updated 2026-03-04
#markdown #reference #showcase

A comprehensive reference for every Markdown element supported by Hexo’s renderer. Use this post to verify that all markdown constructs render correctly in Vaultex.

Tables

Tables align left by default. Alignment hints (:---, :---:, ---:) control column alignment.

Name Type Default Description
vault_name string — Displayed in the vault switcher
font_size number 16 Base body font size in px
posts_per_row number 1 1 = list, 2 = card grid
show_excerpt boolean true Show excerpt on index
toc_depth number 3 Max TOC heading depth

Wide Table

Language Paradigm Typing First Appeared Notable For
JavaScript Multi-paradigm Dynamic 1995 The web’s lingua franca
Python Multi-paradigm Dynamic 1991 Readability, data science
Rust Systems Static 2010 Memory safety without GC
Go Concurrent Static 2009 Simplicity, fast compilation
Haskell Functional Static 1990 Pure FP, lazy evaluation

Images

Images are centered by default and respect the content max-width.

A placeholder image

You can also add a title for tooltip text:

Vaultex logo placeholder

Code

Inline Code

Use backticks for inline code. It renders in Source Code Pro at a slightly reduced size with a subtle background pill.

Reference a file: themes/vaultex/_config.yml. Call a function: hexo.generate(). Use a CLI command: npx hexo server --port 5000.

Fenced Code Blocks

Code blocks support language labels and line numbers:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>Vaultex</title>
  <link rel="stylesheet" href="/css/style.css" />
</head>
<body>
  <div id="app">
    <!-- App shell renders here -->
  </div>
  <script src="/js/vaultex.js"></script>
</body>
</html>

Blockquotes

Single-level blockquote. Great for callouts, quotes from external sources, or highlighting key ideas.

Note: You can use bold, italic, and inline code inside blockquotes.

Multiple paragraphs work too — just separate them with a blank line and continue with >.

First level

Second level — nested quote inside the outer quote.

Third level — deeply nested.

Definition Lists

Some Markdown renderers support definition lists:

Term
The word or phrase being defined.
Vaultex
A dark Hexo theme inspired by the Obsidian.md UI/UX.
Hexo
A fast, simple, and powerful blog framework powered by Node.js.

Footnotes

Footnotes[^1] are rendered inline in some renderers. They link to a reference list at the bottom of the post[^2].

[^1]: This is the first footnote.
[^2]: This is the second footnote, which can contain code and formatting.

Horizontal Rules

Three dashes, asterisks, or underscores produce a <hr>:

Escape Characters

To render literal Markdown characters, escape them with a backslash:

*Not italic* `Not code` [Not a link]

HTML in Markdown

Raw HTML is supported in Hexo’s markdown renderer:

Click to expand

Hidden content revealed on click. This uses native HTML <details> and <summary> elements.

hexo generate && hexo server

Ctrl + Shift + P — the command palette shortcut in VS Code.

Linking

Hexo documentation — external link.

Welcome to Vaultex — internal link to another post.

Hexo is a static site generator. Vaultex is a theme for it.

URLs are automatically linked: https://hexo.io

Email addresses: hello@example.com