持续创作,加速成长!这是我参与「掘金日新计划 · 6 月更文挑战」的第1天,点击查看活动详情
序
接下来的几天中,我将会用一系列文章来讲述如何从头开始一个自己的技术博客。今天是系列的第一篇——Markdown教程。
前言
早期互联网中,博客是最流行的个人发表文字的地方,当时的很多作家、评论员都会选择在自己的博客上发表文章和观点。而随着微博、朋友圈、qq空间等短文字平台的兴起,博客的热度渐渐褪去。但在程序员中,博客的热度不降反增。因为通常技术文章需要讲的内容,并不能简简单单用两三行文字讲清楚。而Markdown使得不同博客平台间的文章格式可以通用,因此现在绝大多数技术博客都是使用Markdown来进行撰写的。
Markdown简介
Markdown是一种标记语言,和HTML类似。但它的写法比HTML简单的多,而且相比于需要一个渲染引擎才能正常显示格式的HTML,Markdown就算用记事本打开,就算从来没有学过Markdown的小白,也可以通过它的纯文本格式推断出来哪里是标题、哪里是重点。因此,目前各大技术网站都将Markdown作为首选的编辑语言。在Github上,基本上每个项目都会有的README.md文件,就是用Markdown写成的。
Markdown基本用法
标题
Markdown使用井号“#”作为标题的关键字,有几个#就代表几级标题。
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
……
这里要注意的是,#和文字之间的空格不能漏。
换行
Markdown中如果只打回车是换不了行的,需要打两次回车,使两段文字中间有一个空行,才能在最终渲染出来的页面中展现出换行的效果。
加粗、斜体
Markdown使用星号*包围文字来表示加粗,使用两边各两个星号*包围文字来表示斜体,使用两边各三个星号*包围文字来表示同时加粗和斜体。
*加粗*
**斜体**
***粗斜体***
但这样的规定会导致在一句话中就是想打两个星号时,两个星号中间的字会变成粗体字,需要使用反斜杠来进行转义:\*
删除线
删除这样的效果是使用波浪线~完成的
~删除~
有序标号
如:
- 一号项目
- 1-1
- 1-2
- 二号项目
- 三号项目 这样的效果非常简单,上面的原始格式和最终的格式基本上没有区别,原始格式如下:
1. 一号项目
1. 1-1
2. 1-2
2. 二号项目
3. 三号项目
需要注意的是.和后面的文字间的空格不能漏
无序标号
如:
- 一号项目
- 1-1
- 1-2
- 二号项目
- 三号项目 这样的效果也同样非常简单,上面的原始格式和最终的格式基本上没有区别,原始格式如下:
* 一号项目
* 1-1
* 1-2
* 二号项目
* 三号项目
需要注意的是*和后面的文字间的空格不能漏
超链接、图片
在Markdown中放上百度这样的超链接格式如下
[百度](baidu.com)
需要插入一张图片的格式和上面类似,但需要在文字前面加上!。比如我插入下面这张图片:
原始的Markdown文本是这样的:

这里前面方括号中的文字是鼠标指向图片并停留后会显示的文字,并不太重要。
插入代码
多行代码
function hello(){
console.log('hello')
return;
}
插入这样的代码,需要用`这个符号将代码包围起来,并标上是哪种编程语言,这样Markdown渲染器会调用对应语言的渲染库来进行渲染。上面代码的原始格式如下
```javascript
function hello(){
console.log('hello')
return;
}
```
`至少需要三个才能实现渲染的效果,超过三个的效果和三个等同。
行内代码
如果只是想在一个句子中间插一句代码,如console.log('hello')
,那么使用一个`将代码包围起来即可,即`console.log('hello')`。
引用
有的时候想要引用其他人的文字,如下面这种格式:
床前明月光,疑似地上霜
就需要用到>符号,上面的原始文本格式如下:
> 床前明月光,疑似地上霜
多行引用,只需要在每一行前面都加上>即可。这里同样需要在两行之间加一个空行。
床前明月光,疑似地上霜
举头望明月,低头思故乡
> 床前明月光,疑似地上霜
>
> 举头望明月,低头思故乡
数学公式
尽管对数学公式的支持并不包含在Markdown的标准中,但目前有非常多的Markdown渲染引擎都已经支持了数学公式,就连之前一直坚持Markdown标准的Github在前一阵子也提供了Markdown数学公式的支持。
Markdown中的数学公式是基于LaTeX的,因此想要在Markdown中写数学公式需要首先了解LaTeX的数学公式用法,这里给出一个参考网站:常用数学符号的 LaTeX 表示方法。
绝大多数的Markdown引擎都是用$符号来表示数学公式的(掘金中也是如此)。如质能转换公式:。它的原始格式如下:
$E=mc^2$
总结
以上就是对Markdown的简介和基本用法的讲解。下一篇文章将讲述如何选择一个适合自己的博客平台