这篇文章是一份可以反复参考的 Markdown 模板。以后写博客时,可以复制这篇的结构,再把内容换成自己的文字。

文章开头怎么写

一篇博客通常可以先用一两段说明这篇文章要讲什么、为什么写、读完能得到什么。

比如:

最近在搭建自己的个人博客,所以顺手记录一下从零开始配置主题、写文章、预览和部署的过程。

这种开头不用太正式,只要能让未来的自己快速想起当时在做什么就很好。

常用的段落结构

正文可以按“小标题 + 说明 + 例子”的方式写:

1. 先说结论

如果文章是教程,可以先把结论写在前面。

2. 再写步骤

步骤适合用有序列表:

  1. 新建一篇 .md 文件
  2. 写好文章头部信息
  3. 保存后刷新本地预览页面
  4. 确认没问题后再部署

3. 最后补充注意事项

注意事项适合用无序列表:

  • 文件名建议用英文、数字和短横线
  • 图片最好放在博客资源目录里
  • 标题、标签、分类都可以慢慢调整

插入代码

写技术笔记时,经常会放代码。代码块要用三个反引号包起来,并写上语言名称:

1
2
3
4
5
6
7
const site = {
name: "梦不见电子羊的blog",
theme: "hexo-theme-aero",
status: "writing",
};

console.log(`${site.name} is ${site.status}.`);

命令也可以这样写:

1
2
npm run build
npm run server

插入链接

链接的写法是:

1
[显示文字](https://example.com)

实际效果:

Hexo 官网

插入图片

如果图片放在主题资源目录,比如:

1
themes/aero/source/image/example.jpg

文章里可以这样引用:

1
![图片说明](/image/example.jpg)

如果图片和文章一起管理,也可以以后再开启 Hexo 的文章资源文件夹功能。刚开始不用想太复杂,先把文章写起来更重要。

引用一句话

引用适合放摘录、想法或提醒:

写博客不是为了立刻写得很好,而是为了给想法留下一个能慢慢变清楚的地方。

表格

简单对比可以用表格:

项目 作用
title 文章标题
date 发布时间
tags 标签
categories 分类

一篇文章的收尾

结尾可以写总结,也可以写下一步计划:

今天这篇先记录 Markdown 的基本写法。下一篇可以试着写一次真正的搭建过程,比如“我是怎么把 Hexo 和 Aero 主题跑起来的”。

写完以后,运行:

1
npm run build

如果没有报错,就可以打开本地页面看看效果。