如何使用 Markdown 书写博客

  • Markdown 是什么?

Markdown是一种轻量级标记语言,你可以简单地理解为HTML的简化版,Markdown简单的语法使阅读和创作文档变得容易。因为语法特别简单而且容易排版,Markdown经常被用来书写个人博客。

Markdown简单易学,语法点很少,基本上一个小时就可以学完。下面将会具体介绍Markdown的基本语法,学会这些,你也可以自己写一篇排版优美的博客了!


  • 基础语法

与HTML一样,Markdown也有自己的文件格式,以md结尾,如:test.md


  • 标题

Markdown标题语法非常简单,只要在文本前面加#号即可,如下:

# 标题1
## 标题2
### 标题3
#### 标题4
##### 标题5

效果如下:

标题1

标题2

标题3

标题4

标题5
  • 引述


在Markdown中使用引述,只需在引用文本前加“>”就行了:

> 这是一个引述
>> 嵌套引述

效果:

这是一个引述

嵌套引述

  • 字体格式


Markdown中,使用文本的格式来斜体文本,使用文本的格式来加粗文本,具体如下(注: _都可以使用*来代替 , 就看你的个人喜好了):


_斜体_

**加粗**

___斜体加粗___

斜体

加粗

斜体加粗

  • 列表

列表语法中,以下符号是等效的: * , - , +

看个人喜好咯.

代码:

- 一
- 二
- 三
    -- 二级列表

效果:

    • 二级列表

有序列表:

1. 一
2. 二
3. 三
4. 四
    - 可以搭配无序列表
    - 4.1
    - 4.2

效果:

    • 可以搭配无序列表
    • 4.1
    • 4.2
  • 链接

Markdown链接有三种格式:

  1. 行内式:
    格式为 [link text](URL 'title text')。

代码:

[百度一下,你就知道](http://www.baidu.com/)

效果:

百度一下,你就知道

  1. 参考式(推荐):

参考式链接的写法相当于行内式拆分成两部分,并通过一个识别符来连接两部分。参考式能尽量保持文章结构的简单,也方便统一管理URL。

个人推荐使用参考式,这样我们可以把URL放在文件开头处,便于修改和管理,参考式相对于行内式有一个明显的优点,就是可以在多个不同的位置引用同一个URL。示例代码如下:

首先,定义链接(两个都是方括号):
第二个方括号内为链接独有的识别符,可以是字母,数字,空白,注意其不区分大小写

[百度][link]
空白形式:
[百度][]

效果:

百度

空白形式:

百度

定义链接内容:
其格式为:[识别符]: URL “title”。
示例代码如下:

[link]: http://www.baidu.com/ "百度"
空白形式:
[百度]: http://www.baidu.com/ "百度"

title 可写可不写, 我一般是先把链接定义在文件开头,然后再在文章内引用。

  1. 直接式

这种形式适合来书写邮箱和引用链接,格式为<URL>
代码:

<www.baidu.com>

<www.example@email.com>

效果:

<www.baidu.com>

www.example@email.com


  • 图片

Markdown中引用图片格式如下:

插入图片的语法和插入超链接的语法基本一致,只是在最前面多一个!。也分为行内式和参考式两种。

格式为 ![img text](URL “title text”)。一样的,title text内容可写可不写。示例代码:

  1. 行内式:
![GitHub](https://avatars2.githubusercontent.com/u/3265208?v=3&s=100 "GitHub,Social Coding")

效果:

GitHub
  1. 参考式(推荐):
![GitHub][github]

[github]: https://avatars2.githubusercontent.com/u/3265208?v=3&s=100 "GitHub,Social Coding"

效果:

GitHub
GitHub

  • 代码块

Markdown中代码块格式如下:
示例:

```python
import os
print("Hello")
```

三个```要独占一行, ```后写上所写的语言名,就可以使用相应语言的语法高亮。
效果:

import os
print("Hello")
  • 表格

Markdown中搭建表格非常简单,语法如下:

使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行

示例代码:

name | age
---- | ---
LearnShare | 12
Mike |  32

更加美观的写法:

|    name    | age |
| ---------- | --- |
| LearnShare |  12 |
| Mike       |  32 |

效果:

name age
LearnShare 12
Mike 32

对齐:
在表头下方的分隔线标记中加入 :,即可标记下方单元格内容的对齐方式:
:--- 代表左对齐
:--: 代表居中对齐
---: 代表右对齐

代码:

| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a    | b      | c     |

效果:

left center right
aaaa bbbbbb ccccc
a b c

  • 目录索引

对一篇长的文章来说,一个带位置定位的目录是很重要的,幸运的是,在Markdown中实现并不难,具体语法与链接相似:
[标题](#要引用的标题内容) 注:标题内容不区分大小写
示例:

## section
- [test](#test)

如上,就可以定位到test标题的位置了。
效果:(简书或者其他一些博客网站貌似不支持页面内目录跳转,这里就不演示了)

section


  • 扩展

1.分隔线

Markdown中,可以在一行中使用三个或更多的 *、- 或 _ 来添加分隔线 要注意与文本之间要有空行:

---

效果:


2.删除线

Markdown使用~~来作为删除线,使用方法如下:
代码:

这是 ~~要删除的文本~~

效果:
这是 要删除的文本

3.字符转义

反斜线(\)用于插入在 Markdown 语法中有特殊作用的字符。
例如:

这是用来 *演示* 的 _文本_
这是用来 \*演示\* 的 \_文本\_

效果:
这是用来 演示文本
这是用来 *演示* 的 _文本_


写在最后

以上,就是Markdown的基本语法了,这些东西熟练掌握后,写几篇个人博客就完全是手到擒来了。

虽然简单,还是要写几篇博客来练习加深记忆,写博客的过程就是学习的过程,不管你写的是什么,哈哈,这是一位大佬跟我说的。这也是我的第一篇博客,接下来我也希望自己能坚持并养成写博客的这个习惯。

如果看完了,就赶紧去写你自己的一篇博客吧!

参考

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,491评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,856评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,745评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,196评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,073评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,112评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,531评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,215评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,485评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,578评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,356评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,215评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,583评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,898评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,497评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,697评论 2 335

推荐阅读更多精彩内容

  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,945评论 4 60
  • 1/各位伙伴,大家好,于玲英语工作室和明师国际教育研究院共同合作推出的图说语篇系列和您见面了!这次我们以外研版八年...
    koalaMindmap阅读 588评论 0 0
  • 衡量一个女人做老婆是否合格,她的容颜并不占有太大比例,最重要是看她能否为老公创造一个美满的家庭,为老公解决后顾之忧...
    星座秘码阅读 529评论 0 0
  • 一人一歌 如果恋爱过 一人一歌 如果分别过 还记得 还记得 那一刻你和我 心底的话变成歌 算委婉吧 不知所措 算暗...
    天赋还没用到阅读 159评论 0 2
  • 一、3 June 2017,忐忑 半个月之后,我又一次踏上去非洲的旅程,这次,5周,为硕士毕业论文做个田野调研。目...
    京津记阅读 316评论 1 0