Where are the posts#

Your post files should be placed in src/content/posts/ directory.
You can also create sub-directories to better organize your posts and assets.

src/content/posts/
├── post-1.md
└── post-2/
    ├── cover.png
    └── index.md

Frontmatter#

---
title: "Some title"
published: 1970-01-01
updated: 1970-01-02
description: "Some description"
image: "https://example.com/example.jpg"
tags: ["Atag", "AnotherTag"]
category: "Some category"
draft: false
lang: "en"
---

Situations for image:

1. Start with http:// or https://: Use web image
2. Start with /: For image in public dir
3. With none of the prefixes: Relative to the markdown file

Heading#

# First-level heading

## Second-level heading

### Third-level heading

#### Fourth-level heading

##### Fifth-level heading

###### Sixth-level heading

TIP

Only first to third level heading will be shown in toc.
To get links for heading, just render post locally and get links from browser.

Text format#

Bold
Italicized
Mistaken
_Subscript
^Superscript
Underlined
Dash-Dash—

Centered

☺…

Quote#

Quote

Code#

This is some code

apt upgrade -y
apt autoremove --purge

TIP

To use 3 backticks in code, use 4 backticks to wrap the codeblock.
To use codeblock in a list, indent the codeblock with 8 spaces.
Language hints are in Languages | Shiki.

Links#

Blog

Custom redirect in post#

<a name="redirect-to-top"></a>

Redirect to top

Paragraph#

This is the first line.
This is the second line.

This is another paragraph.

Image#

List#

1. This is the first item.
   • This is an item
     • This is an item
2. This is the second item.

Task#

• Finished
• Not finished

Footnote#

This is a footnote¹.

Alert#

NOTE

This is a note.

TIP

This is a tip.

IMPORTANT

This is a important message.

WARNING

This is a warning.

CAUTION

This is a caution

This is a custom title

This is another note.

Hidden comment#

This is some text.

Escape markdown format#

Add a backslash (\) before the markdown character. For example, *This is not markdown*.

Tables#

CAUTION

Not working properly, see Bug: table in post is not aligned per markdown setting.

Collapsed content#

Math#

$\sqrt{3x-1}+(1+x)^2$

TIP

To escape math syntax, use \$ inside math block, use <span>$</span> outside math block (only for inline).

Github repo#

Video#