博客文章写作

新建文章

关于文章的写作可以参考hexo官方网站的文档,cmd进入博客所在文件夹,输入:

1
$ hexo new [layout] <title>

其中title为文章标题,layout为文章布局,可输入作为默认,例如,新建一篇名为“短歌行”的文章可以输入:

1
$ hexo new "短歌行"

之后用vscode打开博客文件夹,在source_posts子文件夹下出现“短歌行.md”文件,在这个文件中编辑文章即可。

基本内容写作

完成.md文件创建之后就可以,创作自己的文章了,文章的是以markdown格式排版,省去了类似于word等富文本排版模式的繁琐,固定了排版框架,使文章作者专注于文章内容本身。下面先介绍markdown的几种基本元素。

标题

1
2
3
4
5
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
...

在写文章的时候一般四级标题就够用了,注意在”#”与标题内容之间有一个空格,在vscode中有无空格会带来是否高亮的变化请自行体会。

关于字体

markdown本身支持的字体有限,可以与html配合产生更多效果,但是对于写文章来说自带的几种字体基本够用,毕竟文章重要的是内容而不是炫目的效果。

1
2
3
4
*斜体*
**粗体**
***斜体加粗***
~~删除线~~

列表

这个有点像word中的项目符号,但是符号的种类没有那么丰富,分为无序和有序两种,分别介绍:

1
2
3
* 项目1
+ 项目2
- 项目3

三种写法效果相同:

  • 项目1
  • 项目2
  • 项目3

有序列表比较简单:

1
2
3
1. 项目一
2. 项目二
3. 项目三

效果如下(好像并没有区别,哈啊哈):

  1. 项目一
  2. 项目二
  3. 项目三

代码块

由于markdown对代码的支持非常友好,因此几乎全世界的程序员都喜欢使用markdown来书写readme进行交流,典型的就是最大的同性交友网站github
markdown几乎支持所有的编程语言,插入代码块的方式:

其中“python”为编程语言,显示结果如下,关键字“import”高亮

1
import numpy as np

当代码横向或纵向过长时代码块区域会自动出现横纵滚动条,因此可以不必担心代码量太大引起的布局问题。

表格

使用markdown格式插入表格语法如下,其中“:-”代表对齐方式,“:–:”为居中对齐,“-:”为右对齐。

1
2
3
表头1 | 表头2 |表头3
--|:--:|---:
内容1|内容2|内容3

最终的显示效果:

表头1 表头2 表头3
内容 内容 内容
内容 内容 内容

其它操作


分割线:“—–”,”-“的数量只要大于2个即可

换行:在段落间使用回车添加一个或多个空白行即可实现换行,当然还有其他的插入方式,但是插入空白行的方式使源码具有层次感,更加方便阅读修改。

插入图片:可以插入本地图片,或者网络图片,插入方法为:

1
![](url)

其中url为图片本地路径或者网址。

小结

markdown格式将文档编写人员从复杂的富文本排版中解放出来,可以将更多精力注入文章内容,这与大名鼎鼎的印刷排版工具Latex异曲同工,Latex与TEX的诞生过程也是一段有意思的故事。

当今各大网站、论坛、博客、笔记软件等均支持markdown格式,你甚至可以用markdown的格式写一封邮件,在有道云笔记中你可以用它生成好看的笔记页,遗憾的是微软的onenote不支持该格式,相信不久的将来就会有啦!markdown的入门也十分简单,不像Latex那样门槛颇高,你可以花费10分钟学会它,然后就爱上写文档了。

文章发布

文章编辑完之后就可以发布到网站上了,cmd进入blog所在文件夹,依次输入:

1
2
3
$ hexo g
$ hexo d
$ hexo s -g 5555

刷新网页,就可以看到你最新发布的文章啦!

写在最后

作为非科班出身的bug编写者,要学的东西有很多,学习过程中的记录必不可少,因此我才萌生了做自己的blog的想法,相信这也是与大家交流的媒介,之后的可能会不定期更新文章,记录我的学习之路,接下来的若干篇文章可能是关于C++和Qt的,啥时候写嘛,我也不知道咯,烫烫烫烫烫。