Hexo 与 Markdown 使用指南

Hexo 与 Markdown 使用指南

欢迎阅读这篇关于 Hexo 和 Markdown 的使用指南！这篇文章将展示各种 Markdown 语法效果。

什么是 Hexo？

Hexo 是一个快速、简洁且高效的博客框架。它使用 Markdown 解析文章，在几秒内即可生成静态网页。

Hexo 的特点

  • ⚡ 快速生成：几秒内即可生成数百个页面
  • 🎨 主题丰富：拥有丰富的主题生态系统
  • 📝 Markdown 支持：使用 Markdown 编写文章，简单易学
  • 🔧 插件系统：强大的插件系统，扩展性强

Markdown 语法示例

标题层级

Markdown 支持 6 级标题：

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

文本样式

  • 粗体文字：使用 **粗体**
  • 斜体文字：使用 *斜体*
  • 删除线：使用 ~~删除线~~
  • 行内代码：使用 `代码`

列表

无序列表

  • 第一项
  • 第二项
    • 嵌套项 1
    • 嵌套项 2
  • 第三项

有序列表

  1. 第一步：安装 Node.js
  2. 第二步：安装 Hexo
  3. 第三步：创建博客
  4. 第四步：开始写作

链接和图片

这是一个链接到 Hexo 官网的示例。

示例图片

引用

这是一段引用文字。

引用可以包含多个段落。

— 引用来源

代码块

JavaScript 示例

// Hexo 生成命令
hexo generate

// 启动本地服务器
hexo server

// 部署到远程
hexo deploy

Python 示例

def hello_hexo():
    print("Hello, Hexo!")
    return "欢迎使用 Hexo 博客框架"

hello_hexo()

Bash 示例

# 创建新文章
hexo new "我的第一篇文章"

# 清理生成文件
hexo clean

# 生成并启动服务器
hexo generate && hexo server

表格

功能 命令 说明
创建文章 hexo new "标题" 在 source/_posts 目录创建新文章
生成静态文件 hexo generate 生成静态网站到 public 目录
启动服务器 hexo server 启动本地开发服务器
部署网站 hexo deploy 部署到远程服务器

任务列表

  • 安装 Hexo
  • 配置主题
  • 写第一篇文章
  • 配置评论系统
  • 部署到 GitHub Pages

分割线

Front-matter 配置说明

Front-matter 是文章顶部的配置区域，用于设置文章的元数据：

---
title: 文章标题
date: 2025-01-20
tags: [标签1, 标签2]
categories: 分类
description: 文章描述
cover: 封面图片URL
---

常用配置项

  • title: 文章标题（必需）
  • date: 发布日期（必需）
  • tags: 文章标签（可选）
  • categories: 文章分类（可选）
  • description: 文章描述（可选）
  • cover: 封面图片（可选）
  • comments: 是否显示评论（可选，默认 true）
  • toc: 是否显示目录（可选）

实用技巧

1. 使用 Emoji

Hexo 支持 Emoji 表情：:smile: :heart: :rocket: :star:

2. 注意事项

提示：编写文章时注意以下几点：

  1. Front-matter 必须放在文件最顶部
  2. 使用 --- 包围 Front-matter
  3. 冒号后面要有空格
  4. 保存文件后，Hexo 会自动检测变化

总结

通过这篇文章，你应该了解了：

  1. ✅ Hexo 的基本概念和特点
  2. ✅ Markdown 的各种语法
  3. ✅ Front-matter 的配置方法
  4. ✅ 如何编写一篇完整的文章

现在你可以开始创建自己的博客文章了！

相关链接：

标签：#Hexo #Markdown #博客 #教程