番外篇:博文写作语法提升指南 - 掌握语法技巧,提升文章品质

番外篇: 博文写作语法提升指南 - 掌握语法技巧, 提升文章品质

1. Markdown 介绍

Markdown 是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。

2. 常用语法

  1. 标题:使用#来表示不同级别的标题。例如:
1
2
3
# 一级标题
## 二级标题
### 三级标题
  1. 强调: 使用*_来表示斜体或加粗。例如:
1
2
*斜体文本*
**加粗文本**
  1. 列表

无序列表使用*+-

1
2
- 项目一
- 项目二

有序列表使用数字加.:

1
2
1. 第一项
2. 第二项
  1. 链接:使用[描述](链接)来创建链接。例如:
1
[Google](https://www.google.com)
  1. 图片:类似链接,但前面加一个!。例如:
1
![图片描述](图片链接)
  1. 代码块:使用三个反引号(```)来表示代码块,可以指定语言进行语法高亮。例如:
1
2
3
```python
print("Hello, World!")
```
  1. 引用:使用>来表示引用。例如:
1
> 这是一个引用
  1. 文本高亮:一些Markdown解析器支持特殊语法来实现文本高亮,例如:
1
==这部分文本会被高亮==
  1. 代码行代码行(即内联代码)是指在文本中嵌入一行或几行的代码。例如:
1
`代码`
  1. 表格:表格的每一行用|分隔,表头和内容行之间用---分隔,列对齐方式可以通过在---前后添加:来指定。例如:
1
2
3
4
5
6
7
| 表头1 | 表头2 | 表头3 |


| 左对齐 | 居中对齐 | 右对齐 |
|:-------|:-------:|-------:|
| 文本 | 文本 | 文本 |

3. 新建博文

  1. 新建博文
1
hexo new new-blog-post

  1. 参考设置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
---
title: {{ title }} #【必需】页面标题
date: #【必需】页面创建日期
updated: #【可选】页面更新日期
tags: #【可选】文章标签
categories: #【可选】文章分类
keywords: #【可选】文章关键字
description: #【可选】文章描述
top: # 1 置顶
top_img: #【可选】文章顶部图片
comments: #【可选】显示文章评论模块(默认 true)
cover: #【可选】文章缩略图
toc: #【可选】显示文章 TOC
toc_number: #【可选】显示 toc_number
toc_style_simple: #【可选】显示 toc 简洁模式
copyright: #【可选】显示文章版权模块
copyright_author: #【可选】文章版权作者
copyright_author_href: #【可选】作者链接
copyright_url: #【可选】版权链接
copyright_info: #【可选】版权声明文字
mathjax: #【可选】显示 mathjax
katex: #【可选】显示 katex
aplayer: #【可选】加载 aplayer 的 js 和 css
highlight_shrink: #【可选】配置代码框是否展开
aside: #【可选】显示侧边栏 (默认 true)
swiper_index: 10 #【可选】首页轮播图配置
top_group_index: 10 #【可选】首页右侧卡片组配置
ai: #【可选】文章 ai 摘要
background: "#fff" #【可选】文章主色
---
<div class="video-container">[视频内嵌代码]</div>
<style>.video-container { position: relative; padding-top: 56.25%; } .video-container iframe { position: absolute; top: 0; left: 0; width: 100%; height: 100%; }</style>

  1. 更新并上线
1
2
3
4
5
# 本地预览
hexo cl; hexo s

# 推送更新上线
hexo cl; hexo g; hexo d