大家好,我是老马。

Markdown语法指南

这是一份详细的 Markdown 语法参考,每个特性都附带可直接渲染的示例


基础语法

标题

使用 # 号表示标题层级(支持 1-6 级):

# 一级标题
## 二级标题
### 三级标题

强调

语法 效果 用法
**粗体** 粗体 双星号包裹
*斜体* 斜体 单星号包裹
***粗斜体*** 粗斜体 三星号包裹
~~删除线~~ 删除线 双波浪号包裹

列表

无序列表:

  • 项目一
  • 项目二
    • 子项目(缩进两个空格)

有序列表:

  1. 第一步
  2. 第二步
  3. 第三步

任务列表:


链接与图片

Wiki-Link(双向链接)

Monolith 的核心功能,使用 [[笔记名]] 创建双向链接:

  • [[intro]] → 链接到 [[intro]]
  • [[快速入门]] → 链接到 [[快速入门]]
  • 链接目标不存在时,点击会提示创建新笔记
  • 点击左侧 ↗ 图标查看反向链接

媒体嵌入

使用 ![[文件名]] 嵌入图片、音频、视频、PDF 等。支持拖拽插入和粘贴插入,文件自动保存到 _assets/ 目录。


代码块

使用三个反引号并指定语言,支持语法高亮:

fn fibonacci(n: u32) -> u32 {
    match n {
        0 => 0,
        1 => 1,
        _ => fibonacci(n - 1) + fibonacci(n - 2),
    }
}
def quicksort(arr):
    if len(arr) <= 1:
        return arr
    pivot = arr[len(arr) // 2]
    left = [x for x in arr if x < pivot]
    return quicksort(left) + [pivot] + quicksort([x for x in arr if x > pivot])

代码块右上角有复制按钮,hover 时可见,点击一键复制。


引用

知识就是力量。
— 弗朗西斯·培根

嵌套引用:

一级引用

二级引用


表格

功能 快捷键 说明
保存 Ctrl+S 保存当前文件
搜索 Ctrl+F 打开搜索面板

支持左对齐 :---、居中 :---:、右对齐 ---:


数学公式(KaTeX)

Monolith 支持 LaTeX 数学公式渲染,使用 KaTeX 引擎。

行内公式

$...$ 包裹,在正文中直接插入公式:

  • 质能方程: $E = mc^2$
  • 欧拉恒等式: $e^{i\pi} + 1 = 0$
  • 二次公式: $x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}$

块级公式

$$...$$ 包裹,独立显示:

$$
\int_{-\infty}^{\infty} e{-x2} dx = \sqrt{\pi}
$$

$$
\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}
$$

代码块写法

使用 katexmath 作为代码块语言标识:

\nabla \times \vec{E} = -\frac{\partial \vec{B}}{\partial t}
\begin{pmatrix}
a & b \\
c & d
\end{pmatrix}
\begin{pmatrix}
x \\
y
\end{pmatrix}
=
\begin{pmatrix}
ax + by \\
cx + dy
\end{pmatrix}

Mermaid 图表

流程图

graph TD A[开始] --> B{判断} B -->|是| C[执行操作] B -->|否| D[跳过] C --> E[结束] D --> E

时序图

sequenceDiagram participant 用户 participant Monolith participant 文件系统 用户->>Monolith: 打开笔记 Monolith->>文件系统: 读取文件 文件系统-->>Monolith: 返回内容 Monolith-->>用户: 显示笔记

自动目录 (TOC)

在文档任意位置插入 TOC 即可自动生成目录。以下就是实时生成的本页目录:

点击目录项可平滑滚动到对应标题。


脚注

使用 [^id] 引用脚注,底部自动生成脚注区。这是一段带脚注的文字[1],这是另一段[2]


可折叠内容块

使用 +++标题 开始,+++ 结束,创建可折叠的内容块:

写法

+++ 点击展开:前端框架对比

框架 特点
React 组件化、虚拟 DOM、生态丰富
Vue 渐进式、模板语法、上手简单
Svelte 编译时优化、无虚拟 DOM、体积小
+++

效果

+++ 点击展开:前端框架对比

框架 特点
React 组件化、虚拟 DOM、生态丰富
Vue 渐进式、模板语法、上手简单
Svelte 编译时优化、无虚拟 DOM、体积小
+++

写法

+++ 点击展开:常用正则表达式

  • 邮箱:/^[\w.-]+@[\w.-]+\.\w+$/
  • 手机号:/^1[3-9]\d{9}$/
    +++

效果

+++ 点击展开:常用正则表达式

  • 邮箱:/^[\w.-]+@[\w.-]+\.\w+$/
  • 手机号:/^1[3-9]\d{9}$/
    +++

Frontmatter

在文档开头使用 YAML 格式的 frontmatter 存储元数据:

---
title: 我的笔记
date: 2024-01-01
tags: [技术, 编程]
---

Frontmatter 不会在预览中显示,但可以在 Frontmatter 栏中查看和编辑。其中的 tags 字段会被标签插件自动提取。


图片放大

预览中点击任意图片可全屏放大查看,按 ESC 或点击背景关闭,支持平滑缩放动画。


回到 [[intro]] 查看完整功能列表,或者查看 [[快速入门]] 快速上手。


本内容统一由 永恒之石个人知识库 Monolith 发布。
官网:https://houbb.github.io/monolith-landpage/


  1. 这就是脚注的定义。点击返回箭头可以回到引用处。 ↩︎

  2. 脚注 ID 可以自定义。适合学术写作和详细注释。 ↩︎

posted on 2026-06-07 18:51  老马啸西风  阅读(19)  评论(0)    收藏  举报