This document demonstrates all Markdown formats supported by the Shiroi blog system. Each feature includes both code and effect sections.
I. Basic Text Formatting
Bold
Bold text and another bold
Italic
Italic text and another italic
Bold Italic
Bold italic text
Strikethrough (GFM)
Strikethrough text
Inline Code
This is an inline code example
II. Shiroi Custom Inline Syntax
Spoiler/Hidden Text
Content visible on hover.
This is a text containing spoiler content, visible on hover.
Highlight Mark
This is a highlighted text.
Inserted Text / Underline (Insert)
This is a text that has been inserted.
Social Platform Mention
Supports three platforms: GitHub (GH), Twitter (TW), and Telegram (TG).
III. Headings (H1 - H6)
Headings automatically generate anchor links and support Chinese character slugs.
(Heading effects can be seen in the sections of this document)
IV. Lists
Unordered List
- Item 1
- Nested 1.1
- Nested 1.2
- Item 2
- Item 3
Ordered List
- Step 1
- Step 2
- Sub-step 2.1
- Sub-step 2.2
- Sub-step 2.2.1
- Step 3
GFM Task List
- Unfinished task
- Completed task
- Another to-do item
V. Links and Images
Normal Link
Automatic Link
Images
A natural landscape image
VI. Quotes
Normal Quote
This is a normal quote text.
Nested quotes are also supported.
GFM Alerts (GitHub-style Alert Boxes)
Note: Multiple adjacent Alerts need to be separated by <div />, otherwise they will be merged into a single blockquote.
[!NOTE] This is a NOTE message, used to supplement information users should be aware of.
TipThis is a TIP message, providing better operational suggestions.
ImportantThis is an IMPORTANT message that users need to know to achieve their goals.
WarningThis is a WARNING message, requiring immediate user attention to avoid problems.
CautionThis is a CAUTION message, warning of risks or negative consequences of certain operations.
VII. Tables (GFM)
| Feature | Syntax | Description |
|---|---|---|
| Bold | **text** | Bold display |
| Italic | *text* | Italic display |
| Highlight | ==text== | Mark highlight |
| Insert | ++text++ | Underline |
VIII. Code Blocks (Shiki Highlighting)
Supports syntax highlighting for 200+ languages, using GitHub Light/Dark themes.
TypeScript
JSX/TSX
Diff Marking
IX. Math Formulas (KaTeX)
Inline Formula
Einstein's mass-energy equivalence equation:$ E = mc^2 $
Quadratic formula:$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$
Polynomial:$P(x) = anx^n+a{n-1}x^{n-1} + \dots + a1x + a0$
Block Formula
X. Footnotes (GFM Footnotes)
Footnotes support interactive pop-up previews, clicking jumps to the footnote definition.
This is a text containing a footnote[^1], and another footnote[^note].
XI. Container Blocks (::: Syntax)
Alert/Tip Containers
Supported types: info, warning, error, success, note (equivalent to info), danger (equivalent to error).
info.error.Banner Containers
Types are specified via curly brace parameters: {warn}, {error}, {info}, {success}.
Image Carousel (Gallery / Carousel)
Supports both Markdown image syntax and direct URL, gallery and carousel have the same effect.
Grid Layout (Grid)
Parameters: cols (number of columns), gap (spacing, default 8), rows (number of rows), type (normal or images).
Grid Cell 1
Grid Cell 2
Grid Cell 3
Image Grid (Grid type=images)
Masonry Layout (Masonry)
Parameters: gap (spacing, default 8). Responsive automatic column adjustment.
XII. Rich Link Auto Embedding
URLs on a separate line are automatically recognized and rendered as rich cards or embedded content, without any additional syntax.
GitHub Repository Card
GitHub Commit
GitHub PR
GitHub Issue
GitHub File Preview (with code line highlighting)
GitHub Gist Embedding
https://gist.github.com/Innei/94b3e8f078d29e1820813a24a3d8b04e
YouTube Video Embedding
Twitter/X Tweet Embedding
Bilibili Video Embedding
CodeSandbox Embedding
Normal External Link (Automatic Preview Card)
URLs not matching specific platforms will attempt to match via plugins and render as generic link preview cards.
https://trpc.io/docs/client/react/useInfiniteQuery
Inline Links (Will not become cards)
When a URL is not on a separate line but in the middle of a paragraph, it will not be rendered as a card, but as a normal link.
Inline Innei
Inline https://github.com/Innei
XIII. LinkCard Component
Manually create link cards using custom HTML tags, with precise control over source and ID.
GitHub Repository Card
GitHub Commit Card
Internal Article Card
All Supported Source Types
XIV. Tabs
React is a JavaScript library for building user interfaces.
XV. Collapsible Panel (Details / Summary)
Supports animated expand/collapse, automatically expands when printing.
XVI. Video
XVII. Special Code Blocks
Mermaid Flowchart
Excalidraw Whiteboard
Excalidraw clipboard JSON data can be directly pasted into the code block for rendering.
Remote React Component Rendering
Load remote React components via CDN and render them on the page.
XVIII. Horizontal Rule
Three ways to write with the same effect:
XIX. HTML Inline Elements
Superscript
x2 + y2 = z2
Subscript
H2O is the chemical formula for water
XX. Format Quick Reference
| Category | Syntax | Description |
|---|---|---|
| Standard Markdown | **粗体** | Bold |
*斜体* | Italic | |
`代码` | Inline code | |
> 引用 | Blockquote | |
[文本](url) | Link | |
 | Image | |
--- | Horizontal rule | |
| GFM Extensions | ~~删除线~~ | Strikethrough |
- [x] 任务 | Task list | |
| 表格 | | Table | |
[^1] | Footnote | |
> [!NOTE] | GitHub Alert | |
| Shiroi Extensions | ||剧透|| | Hover to show |
==高亮== | Text mark | |
++插入++ | Underline/Insert | |
{GH@user} | Social Mention | |
| Math Formulas | $ 行内公式 $ | KaTeX inline |
$$ 块级公式 $$ | KaTeX block | |
| Container Blocks | ::: info/warning/error/success | Tip container |
::: banner {type} | Banner | |
::: gallery / ::: carousel | Image carousel | |
::: grid {cols=N,gap=N} | Grid layout | |
::: grid {type=images} | Image grid | |
::: masonry {gap=N} | Masonry layout | |
| Custom Components | <LinkCard source="" id=""> | Link Card (13 sources) |
<Tabs><Tab label=""> | Tabs | |
<details><summary> | Collapsible panel | |
<Video src=""> | Video playback | |
| Special Code Blocks | `mermaid | Mermaid chart |
`excalidraw | Excalidraw whiteboard | |
`component | Remote React component | |
| Rich Links | 独立行 URL | Auto-embed card |
- 1: This is the content of the first footnote.Return1
- note: This is the content of the second footnote, supporting interactive pop-up previews.Returnnote