这篇文章是一份可以反复参考的 Markdown 模板。以后写博客时,可以复制这篇的结构,再把内容换成自己的文字。
文章开头怎么写
一篇博客通常可以先用一两段说明这篇文章要讲什么、为什么写、读完能得到什么。
比如:
最近在搭建自己的个人博客,所以顺手记录一下从零开始配置主题、写文章、预览和部署的过程。
这种开头不用太正式,只要能让未来的自己快速想起当时在做什么就很好。
常用的段落结构
正文可以按“小标题 + 说明 + 例子”的方式写:
1. 先说结论
如果文章是教程,可以先把结论写在前面。
2. 再写步骤
步骤适合用有序列表:
- 新建一篇
.md文件 - 写好文章头部信息
- 保存后刷新本地预览页面
- 确认没问题后再部署
3. 最后补充注意事项
注意事项适合用无序列表:
- 文件名建议用英文、数字和短横线
- 图片最好放在博客资源目录里
- 标题、标签、分类都可以慢慢调整
插入代码
写技术笔记时,经常会放代码。代码块要用三个反引号包起来,并写上语言名称:
1 | |
命令也可以这样写:
1 | |
插入链接
链接的写法是:
1 | |
实际效果:
插入图片
如果图片放在主题资源目录,比如:
1 | |
文章里可以这样引用:
1 | |
如果图片和文章一起管理,也可以以后再开启 Hexo 的文章资源文件夹功能。刚开始不用想太复杂,先把文章写起来更重要。
引用一句话
引用适合放摘录、想法或提醒:
写博客不是为了立刻写得很好,而是为了给想法留下一个能慢慢变清楚的地方。
表格
简单对比可以用表格:
| 项目 | 作用 |
|---|---|
title |
文章标题 |
date |
发布时间 |
tags |
标签 |
categories |
分类 |
一篇文章的收尾
结尾可以写总结,也可以写下一步计划:
今天这篇先记录 Markdown 的基本写法。下一篇可以试着写一次真正的搭建过程,比如“我是怎么把 Hexo 和 Aero 主题跑起来的”。
写完以后,运行:
1 | |
如果没有报错,就可以打开本地页面看看效果。