搭建好自己的博客后,贵在坚持写了,但写博客之前需要弄明白MarkDown语法,在此总结写博客时,需要做的的一些语法,也方便自己查阅。
写文章前,我以hexo博客的样式进行说明,首先需要在你的hexo\source\_posts\
文件夹下执行:
hexo new [layout] "postName"
其中layout
是可选参数,默认值为post
.有哪些layout
呢,请到scaffolds
目录下查看,这些文件名称就是layout
名称。当然你可以添加自己的layout
,方法就是添加一个文件即可,同时你也可以编辑现有的layout
,比如post
的layout
默认是hexo\scaffolds\post.md
。然后pastName
可自定义命名。
title: { { title } } #文章页面上的显示名称,可以任意修改
date: { { date } } #文章生成时间,一般不改,当然也可以任意修改
tags: #文章标签,可空。也可以按照你的习惯写分类名字,注意后面有空格
---
这里是你博客列表显示的摘要文字
<!--more-->
以下是博客的正文,以上面的格式为分隔线
请注意,大括号与大括号之间我多加了个空格,否则会被转义,不能正常显示。
下面正式写一些markdown
的语法格式
-
代码块
程序员最主要的还是以代码的编写为主,所以把这个放在第一位(因为我就折腾了好久,不知道怎么添加代码的情况)
1.第一种添加代码块的方式
···
代码正文
···
注意:这里的“·”是Esc下的“`”,输入法是英文模式,不要写错,符号后面可以根据主题添加java、javascript等;Markdown会自行使用java、javascript代码颜色进行渲染
2.第二种添加代码块的方式
每行文字前加4个空格或者1个Tab,如
val s = "hello Markdown"
val s = "world Markdown"
-
行内代码
使用``表示行内代码,实例如下:
这是
java
代码
-
标题
三个或更多
大标题
===============
小标题
---------------
大标题
小标题
# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题
这是一级标题
这是二级标题
这是三级标题
这是四级标题
这是五级标题
这是六级标题
-
强调
//星号与下划线都可以,单是斜体,双是粗体,符号可跨行,符号可加空格
**生活除了眼前的苟且,还有诗和远方的田野**
_我一直很奇怪,到底是谁拿了潘玮柏的麦克风?_
**又是谁在敲打我窗?**
_又是谁说七里香的名字很美?以及谁哭着对我说:“童话里的故事都是骗人的?!”_
__显然是,是他,是他,就是他,我们的好朋友,小哪吒~~~__
生活除了眼前的苟且,还有诗和远方的田野
我一直很奇怪,到底是谁拿了潘玮柏的麦克风?
又是谁在敲打我窗?
又是谁说七里香的名字很美?
以及谁哭着对我说:“童话里的故事都是骗人的?!”
显然是,是他,是他,就是他,我们的好朋友,小哪吒~~~
-
分割线
//三个或更多的 -_*,必须单独一行,可含空格
---
-
引用
//二级与三级引用前的空格必须要,一级的可不要
> 这是一级引用
>> 这是二级引用
>>> 这是三级引用
这是一级引用
这是二级引用
这是三级引用
-
有序列表
//数字不能省略但可无序,点号之后的空格不能少
1. 有序列表
2. 有序列表
3. 有序列表
4. 有序列表
9. 有序列表
- 有序列表
- 有序列表
- 有序列表
- 有序列表
- 有序列表
-
无序列表
//符号之后的空格不能少,-+*效果一样,但不能混合使用,因混合是嵌套列表
* 无序列表
* 无序列表
* 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
- 无序列表
-
嵌套列表
// -+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少
- 嵌套列表
+ 嵌套列表
+ 嵌套列表
- 嵌套列表
* 嵌套列表
- 嵌套列表
+ 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
- 嵌套列表
-
文字超链
//[](链接)的格式
[Simon的博客](http://simontse.github.io/)
-
图片超链
//多个感叹号,要设置大小只能借助HTML标记
![GitHub Mark](http://upload-images.jianshu.io/upload_images/2144048-003e5c96bc6c6304.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
-
另外一种图片链接
![](http://upload-images.jianshu.io/upload_images/2144048-c6997dbca5f9b667.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
-
自动链接
<http://simontse.github.io/>
<xiejx_op@foxmail.com/>
-
转义字符
Markdown中的转义字符为\,转义的有:
\\ 反斜杠
\` 反引号
\* 星号
\_ 下划线
\{\} 大括号
\[\] 中括号
\(\) 小括号
\# 井号
\+ 加号
\- 减号
\. 英文句号
\! 感叹号
-
插入表格
| 左对齐标题 | 右对齐标题 | 居中对齐标题 |
| :------| ------: | :------: |
| 短文本 | 中等文本 | 稍微长一点的文本 |
| 稍微长一点的文本 | 短文本 | 中等文本 |
左对齐标题 | 右对齐标题 | 居中对齐标题 |
---|---|---|
短文本 | 中等文本 | 稍微长一点的文本 |
稍微长一点的文本 | 短文本 | 中等文本 |
语法说明:
-
|
、-
、:
之间的多余空格会被忽略,不影响布局。 -
-:
表示内容和标题栏居右对齐,:-
表示内容和标题栏居左对齐,:-
:表示内容和标题栏居中对齐。 - 内容和|之间的多余空格会被忽略,每行第一个|和最后一个|可以省略,-的数量至少有一个。
这里需要 注意 的是,表格要插入文本中,需要顶格从左往右写,不可有空格,不然是无法显示的。
以上就是我总结的写博客需要用到的markdown
语法格式。