常用Markdown基本语法

发表于 更新于 分类于

本项目使用AI辅助创作生成。

博客文章模板

文章标签：[博客模板] [写作指南] [Markdown] [NexT主题] [AI创作]

阅读时长：约 15 分钟

版权所有 © 2026 Luhill 未经授权禁止转载

假装这是一张图片

一、模板概述

1.1 模板介绍

本文档是一份通用 Hexo + NexT 主题博客文章模板，旨在为博客作者提供一个功能完备、样式丰富的写作范本。通过从本文档复制内容到您的 _posts/ 目录下的 .md 文件中，您可以快速创建具有专业外观和丰富功能的博客文章。

本模板基于 Hexo 静态网站生成器 和 NexT 主题 构建，完美兼容 Gemini 或 Pisces 布局方案。NexT 主题是 Hexo 生态中最受欢迎的主题之一，以其优雅的设计和强大的功能著称。

1.2 核心特性

本模板为您提供了以下核心功能支持：

  • 内容加密：保护敏感文章内容，支持密码访问
  • 目录导航：自动生成文章目录，支持层级折叠
  • 标签管理：灵活的标签和分类系统
  • 版权声明：多种版权许可证选项
  • AI声明：规范的AI创作内容标识
  • 数学公式：MathJax 和 KaTeX 支持
  • 流程图：Mermaid 和 Flowchart 支持
  • 多媒体：音频和视频嵌入

二、Front-matter 配置说明

2.1 基础配置

在每篇博客文章的开头，您需要设置以下 Front-matter 参数：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
---
title: {{ title }}
date: {{ date }}
updated: {{ date }}
tags: [标签1, 标签2]
categories: [分类名称]
keywords: [关键词1, 关键词2]
description: 这是一篇关于...的文章摘要，用于在首页展示。
top_img: /images/cover.jpg   # 文章顶部特色图
cover: /images/cover.jpg      # 文章在列表页的缩略图
comments: true                # 是否开启评论
toc: true                     # 是否开启文章目录
toc_number: true              # 是否显示目录编号
toc_style_simple: false       # 是否启用简洁目录
copyright: true               # 是否显示版权信息
mathjax: false                # 是否开启数学公式支持
katex: false                  # 是否开启KaTeX数学公式渲染
mermaid: true                 # 是否开启Mermaid流程图
swiper_index: 1                # 轮播图优先级
top_group_index: 1             # 首页置顶文章分组优先级
aside: true                    # 是否显示侧边栏
---

2.2 加密配置

要加密保护您的文章，只需在 Front-matter 中添加密码字段：

1
2
3
---
password: your_secret_password
---

当读者访问该文章时，将需要输入正确的密码才能查看完整内容。

2.3 AI创作声明

对于AI辅助生成的内容，建议添加AI声明字段：

1
2
3
4
---
ai_content: true
ai_generated: true
---

三、基础 Markdown 语法

3.1 文本格式

这是一段普通的段落，用于展示基础的 Markdown 语法。您可以加粗文字，也可以斜体文字，或者进行删除线测试。

加粗文本的使用场景包括：

  • 强调重要概念
  • 标题和关键术语
  • 行动号召

斜体文本通常用于：

  • 引用和说明
  • 书籍、电影等作品名称
  • 专业术语

删除线用于表示：

  • 过时信息
  • 错误内容
  • 待删除的文本

3.2 链接和引用

这是一个超链接，指向 NexT 主题官网。

邮箱引用：您可以通过以下方式引用邮箱地址：

  • 联系邮箱：<service#luhill.icu>
  • 商务合作：<business#luhill.icu>
  • 技术支持：<support#luhill.icu>

网址引用：

3.3 标题分级

1
2
3
4
5
6
# H1 标题（通常一篇文章只有一个）
## H2 标题
### H3 标题
#### H4 标题
##### H5 标题
###### H6 标题

3.4 列表

无序列表

  • 项目一
  • 项目二
    • 子项目 2.1
    • 子项目 2.2
  • 项目三

有序列表

  1. 第一步
  2. 第二步
    1. 第二步的子步骤
    2. 第二步的另一个子步骤
  3. 第三步

3.5 引用块

这是一段引用的文字。
它可以有多行。

甚至可以包含其他 Markdown 元素，比如 加粗。

四、表格展示

4.1 基础表格

以下是基础表格的展示，用于对比不同功能的支持情况：

功能名称 支持情况 备注说明
Markdown 基础 ✅ 完全支持
NexT 标签插件 ✅ 丰富多样
第三方评论 ✅ Valine, Gitalk 等
数学公式 ✅ 需配置开启
流程图 ✅ Mermaid 支持
代码高亮 ✅ 多种主题
加密保护 ✅ hexo-blog-encrypt

4.2 复杂表格

以下是一个更复杂的表格展示，用于项目管理或数据统计：

序号 任务名称 优先级 负责人 开始日期 结束日期 状态
1 模板设计 P0 张三 2024-01-01 2024-01-15 ✅已完成
2 功能开发 P0 李四 2024-01-10 2024-02-01 🔄进行中
3 测试验证 P1 王五 2024-02-01 2024-02-10 ⏳待开始
4 文档编写 P1 赵六 2024-02-05 2024-02-15 ⏳待开始
5 发布上线 P2 钱七 2024-02-15 2024-02-20 ⏳待开始

4.3 对齐方式说明

左对齐 居中对齐 右对齐
内容向左对齐 内容居中 内容向右对齐
使用 :--- 使用 :---: 使用 ---:

五、代码展示

5.1 行内代码

这是 printf("Hello World!") 的一个示例。

您也可以使用 const greeting = "Hello, World!"; 来展示 JavaScript 代码。

5.2 普通代码块

JavaScript 示例

1
2
3
4
5
6
// 这是一个 JavaScript 代码示例
function sayHello(name) {
    console.log(`Hello, ${name}!`);
}

sayHello('NexT');

Python 示例

1
2
3
4
5
6
7
# 这是一个 Python 代码示例
def say_hello(name):
    """Say hello to someone."""
    print(f"Hello, {name}!")

if __name__ == "__main__":
    say_hello("NexT Theme")

5.3 带高亮行和标题的代码块

[hello.py] {1,3-4}
1
2
3
4
5
6
7
# 这是一个 Python 代码示例
def say_hello(name):
    """Say hello to someone."""
    print(f"Hello, {name}!")

if __name__ == "__main__":
    say_hello("NexT Theme")

六、NexT 主题内置标签插件

NexT 提供了丰富的内置标签插件，可以直接在 Markdown 中使用。

6.1 文本居中

生活不止眼前的苟且，还有诗和远方的田野。

或者使用简写：

NexT 主题，优雅与强大并存。

6.2 引用块增强

这是一个 Pull Quote，通常用于在文章中突出显示一段重要的引文，它会浮动在文章的右侧。

这里是正文内容，你会发现上面的引用块浮动在旁边，使得页面布局更加生动有趣。

6.3 按钮

使用按钮可以引导用户进行特定操作：

访问 NexT 官网

参数说明：{% btn 链接, 文字, 图标位置, 图标类 %}

6.4 便签 (Note)

NexT 的 Note 标签非常实用，有多种预设样式：

这是一个默认风格的 Note 便签。

提示信息： 这是一条主要的提示信息。

✓ 任务已完成！恭喜你成功配置了 Note 标签。

⚠️ 警告：请谨慎操作，该操作不可逆。

❗ 危险：发生严重错误！

ℹ️ 信息：今天是美好的一天。

6.5 标签页 (Tabs)

通过 Tabs 标签，可以在同一区域展示多块内容，节省页面空间：

这是第一页的内容。你可以在这里写 Markdown 语法。

这是第二页的内容，包含了代码：

1
console.log('Hello from tab 2');

这是第三页的内容，可以放图片等。
图片替代文字

6.6 音频与视频

NexT 支持直接嵌入音频和视频文件（需路径正确）：

七、高级功能

7.1 数学公式 (MathJax / KaTeX)

当您在 Front-matter 中开启 mathjax: true 或 katex: true 后，即可渲染数学公式：

行内公式：$E = mc^2$

独立公式：
$$
\frac{\partial u}{\partial t} = h^2 \left( \frac{\partial^2 u}{\partial x^2} + \frac{\partial^2 u}{\partial y^2} + \frac{\partial^2 u}{\partial z^2} \right)
$$

7.2 流程图 (Mermaid)

当您在 Front-matter 中开启 mermaid: true 后，可以绘制流程图、时序图等：

流程图示例：

1
2
3
4
5
6
graph TD;
    A[开始] --> B{判断条件};
    B -- 是 --> C[执行操作1];
    B -- 否 --> D[执行操作2];
    C --> E[结束];
    D --> E;

时序图示例：

1
2
3
4
5
6
7
8
9
sequenceDiagram
    participant 用户
    participant 浏览器
    participant 服务器

    用户->>浏览器: 访问博客
    浏览器->>服务器: 请求页面
    服务器-->>浏览器: 返回HTML
    浏览器-->>用户: 渲染页面

7.3 传统流程图 (Flowchart)

您也可以使用传统的 flowchart 语法：

st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认？

st->op->cond
cond(yes)->e
cond(no)->op

八、图片处理

8.1 普通图片

NexT 主题预览

8.2 带标题的图片

使用 <center> 标签或 Markdown 的引用语法可以为图片添加说明。

8.3 图片组

如果您希望图片以画廊形式展示，可以使用以下标签：

参数 2-2 表示每行显示 2 张图片，共 2 行。

九、声明与许可

9.1 AI创作声明

⚠️ AI创作声明

本文全部/部分内容由AI辅助生成，包括但不限于：

  • 文章结构设计
  • 内容撰写与润色
  • 代码示例编写
  • 数据整理与分析

AI生成内容可能存在不准确或不完善之处，读者应自行判断并承担相关风险。

生成时间：2024年1月25日 15:30:00
生成模型：Advanced AI Model v2.0

9.2 版权声明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
=================================================================
                        版权声明
=================================================================

本文档及其内容受中华人民共和国著作权法保护。
版权所有 © 2026 Luhill

未经授权，任何单位和个人不得以任何方式复制、
传播、转载或使用本文档的全部或部分内容。

授权方式：
- 个人学习：免费使用，请注明出处并标明作者
- 商业使用：请联系作者获取授权
- 转载引用：需获作者书面许可，并注明来源

侵权必究！
=================================================================

9.3 许可证信息

许可证类型 适用范围 使用条件
CC BY-NC-SA 4.0 非商业性使用 署名 + 相同方式共享
商业许可证 商业项目 联系作者获取
MIT License 开源项目 自由使用

十、文章结尾信息

根据主题配置，文章结尾会自动显示：

  • 版权声明：作者、链接、声明等信息。
  • 标签云：本文所属的标签。
  • 相关文章推荐：基于标签自动推荐。
  • 打赏二维码：如果您在主题中配置了打赏功能。

十一、参考资料

参考资料：

  1. NexT 主题官方文档：https://theme-next.js.org/
  2. Hexo 官方文档：https://hexo.io/
  3. 社区美化教程：https://cloud.tencent.com/developer/article/2129800
  4. Markdown 官方文档：https://www.markdownguide.org/
  5. GitHub Flavored Markdown：https://github.github.com/gfm/
  6. 官网：https://www.luhill.icu

十二、总结

以上几乎涵盖了 NexT 主题的所有常用功能。如果您还有其他需求，可以参考官方文档进行深度定制。祝您的博客之旅愉快！

温馨提示：如需获取最新版本或反馈问题，请访问我们的官方网站或通过上述联系方式与我们取得联系。