常用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.2 加密配置
要加密保护您的文章,只需在 Front-matter 中添加密码字段:
1 |
|
当读者访问该文章时,将需要输入正确的密码才能查看完整内容。
2.3 AI创作声明
对于AI辅助生成的内容,建议添加AI声明字段:
1 |
|
三、基础 Markdown 语法
3.1 文本格式
这是一段普通的段落,用于展示基础的 Markdown 语法。您可以加粗文字,也可以斜体文字,或者进行删除线测试。
加粗文本的使用场景包括:
- 强调重要概念
- 标题和关键术语
- 行动号召
斜体文本通常用于:
- 引用和说明
- 书籍、电影等作品名称
- 专业术语
删除线用于表示:
- 过时信息
- 错误内容
- 待删除的文本
3.2 链接和引用
这是一个超链接,指向 NexT 主题官网。
邮箱引用:您可以通过以下方式引用邮箱地址:
- 联系邮箱:<service#luhill.icu>
- 商务合作:<business#luhill.icu>
- 技术支持:<support#luhill.icu>
网址引用:
3.3 标题分级
1 | # H1 标题(通常一篇文章只有一个) |
3.4 列表
无序列表
- 项目一
- 项目二
- 子项目 2.1
- 子项目 2.2
- 项目三
有序列表
- 第一步
- 第二步
- 第二步的子步骤
- 第二步的另一个子步骤
- 第三步
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 | // 这是一个 JavaScript 代码示例 |
Python 示例
1 | # 这是一个 Python 代码示例 |
5.3 带高亮行和标题的代码块
1 | # 这是一个 Python 代码示例 |
六、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 | graph TD; |
时序图示例:
1 | sequenceDiagram |
7.3 传统流程图 (Flowchart)
您也可以使用传统的 flowchart 语法:
st=>start: 开始
e=>end: 结束
op=>operation: 我的操作
cond=>condition: 确认?
st->op->cond
cond(yes)->e
cond(no)->op
八、图片处理
8.1 普通图片

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 | ================================================================= |
9.3 许可证信息
| 许可证类型 | 适用范围 | 使用条件 |
|---|---|---|
| CC BY-NC-SA 4.0 | 非商业性使用 | 署名 + 相同方式共享 |
| 商业许可证 | 商业项目 | 联系作者获取 |
| MIT License | 开源项目 | 自由使用 |
十、文章结尾信息
根据主题配置,文章结尾会自动显示:
- 版权声明:作者、链接、声明等信息。
- 标签云:本文所属的标签。
- 相关文章推荐:基于标签自动推荐。
- 打赏二维码:如果您在主题中配置了打赏功能。
十一、参考资料
参考资料:
- NexT 主题官方文档:https://theme-next.js.org/
- Hexo 官方文档:https://hexo.io/
- 社区美化教程:https://cloud.tencent.com/developer/article/2129800
- Markdown 官方文档:https://www.markdownguide.org/
- GitHub Flavored Markdown:https://github.github.com/gfm/
- 官网:https://www.luhill.icu
十二、总结
以上几乎涵盖了 NexT 主题的所有常用功能。如果您还有其他需求,可以参考官方文档进行深度定制。祝您的博客之旅愉快!
温馨提示:如需获取最新版本或反馈问题,请访问我们的官方网站或通过上述联系方式与我们取得联系。