Markdown 零基础教学与博文规范 ​

你好！这篇文档将带你走进 Markdown 的世界。Markdown 是一种轻量级的标记语言，它允许你使用易读、易写的纯文本格式编写文档，然后转换成结构化的 HTML。对于前端开发者和技术博主来说，它是必不可少的工具。

一、 Markdown 基础语法 ​

1. 标题 ​

使用 # 号表示标题，# 的数量代表标题的级别（1-6 级）。

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

2. 字体样式 ​

• 加粗：用两个星号包裹 **这是加粗**
• 斜体：用一个星号包裹 *这是斜体*
• 删除线：用两个波浪号包裹 ~~这是删除线~~

3. 列表 ​

• 无序列表：使用 -、+ 或 * 加上空格。
• 有序列表：使用数字加上 . 加上空格。
• 任务列表：使用 - [ ] (未完成) 或 - [x] (已完成)。

4. 代码块 ​

• 行内代码：用反引号包裹 console.log()。
• 代码块：使用三个反引号包裹，并可以指定语言。

function hello() {
  console.log("Hello, MoSi!");
}

5. 链接与图片 ​

• 链接：[显示的文字](URL地址)
• 图片：![图片描述](图片路径)

二、 本站（Valaxy）特色语法 ​

我们的博客基于 Valaxy 引擎，支持一些更强大的功能：

1. Front Matter (文章元数据) ​

每篇博文的最顶部必须有一段被 --- 包裹的内容，这叫 Front Matter。它告诉系统这篇文章的标题、日期和分类。

---
title: 文章标题
date: 2025-10-08
categories:
  - 碎碎念
tags:
  - Markdown
---

2. UnoCSS 图标 ​

你可以在文章中直接使用图标，例如：

• <div class="i-ri-heart-line"></div> 会显示一个爱心图标。
• 更多图标可以在 Icones 搜索，格式通常是 i-图标库-图标名。

3. 引用块 (Blockquote) ​

使用 > 表示引用：

这是一个引用块，适合放置参考资料或特别提醒。

三、 博文书写与管理规范 ​

为了让博客看起来更整洁，建议遵循以下规范：

1. 文件命名 ​

• 统一使用小写字母和连字符，例如：my-first-post.md。
• 放在 pages/posts/ 目录下。

2. 分类 (Categories) 建议 ​

目前本站预设了几个常用分类：

• 啃啃原理：用于整理面试核心知识点。
• 代码输出：用于记录常用代码块。
• 算法：用于记录 LeetCode 刷题笔记。
• 碎碎念：用于生活记录或学习心得。
• 面试指南：用于求职经验分享。

3. 图片管理 ​

• 可以将图片放在 public/ 目录下，然后在 Markdown 中通过 /图片名 引用。
• 或者通过后台管理界面直接上传。

希望这篇指南能帮你快速上手博客写作！如果有任何疑问，随时问我。