Markdown
初探
导读
前面已经介绍了如何生成一个
Hexo
博客,也简单的介绍了写博客使用的工具Typora
.那什么是
Typora
?它是一个所见即所得的markdown
工具.那什么是
markdown
?它的基本语法是什么?这是下面我们主要介绍的.
什么是markdown
Markdown 是目前互联网上最流行的写作语言,它使用一些简单的符号(* / ` > [] () #)来标记文本格式,其简洁的语法、优美的格式以及强大的软件支持深受广大网友的喜爱。
维基百科上对 Markdown 的描述:
Markdown 是一种轻量级标记语言,创始人是约翰·格鲁伯(John Gruber)。它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 HTML 文档。”
大家千万不要被一些专业术语唬住了,其实 Markdown 之所以流行,最主要的原因就是因为它的学习门槛很低,你可能只需花几分钟就可以入门了。
如何写markdown
在练习写
markdown
之前,我建议你下载一个typora
,因为他所见即所得,你可以一边写一边对照源码.当然了市面上也存在着很多的markdown
编辑器.这个看个人的喜好,可以自己去尝试其他的编辑器.
typora
:https://typora.io/注意:
markdown
文件都是以.md
结尾的.可以下载语法文件(https://github.com/ningwenyan/MyNote/blob/master/MarkDown初探.md)
,对照练习.
基本语法
使用该文件测试和展示
Github
的markdown语法。Github
的markdown
语法在标准的语法上做了补充,称为Github Flavored Markdown
.简称GFM,GFM在Github
上有广泛的应用,README,issues和wiki
都支持markdown语法.
目录
***,---,___
都用来表示分割线
语法 | 使用 | 效果 |
---|---|---|
***,---,___ | 分割线(用在一行开头) | |
# | 一级标题 | 标题 |
## | 二级标题 | 标题 |
### | 三级标题 | 标题 |
#### | 四级标题 | 标题 |
##### | 五级标题 | 标题 |
###### | 六级标题 | 标题 |
普通文本 | 直接输入 | 普通文本 |
单行文本 | 在一行的开头就一个tab 或者4个空格 | 单行文本 |
文本块 | 语法一:在连续几行的文本开头加tab或4个空格 语法二:使用一对各三个的反引号 | 文本块 |
文本高亮 | 使用一对反引号 | linux 学习 |
换行 | 直接回车不能换行,可以在两行文本之间补一个空行 使用换行符 <br> | abr |
*斜体1* | 斜体1 | |
_斜体2_ | 斜体2 | |
**粗体1** | 粗体1 | |
__粗体2__ | 粗体2 | |
这是一个 ~~删除线~~ | 这是一个 | |
***斜粗体1*** | 斜粗体1 | |
___斜粗体2___ | 斜粗体2 | |
***~~斜粗体删除线1~~*** | ||
~~***斜粗体删除线2***~~ | ||
斜体,粗体,删除线可以直接混合使用 | ||
![alt](URL title) | alt :显示图片失败时显示的文本URL title :URL :图片的URL地址,如果是仓库中的图片,直接使用相对路径就可以了,如果是其他仓库中的图片要注意格式, 仓库地址/raw/分支名/图片路径 title :鼠标停留在图片上时显示的文字 | ![google](https://www.google.com/ images/logo.gif "goolge") |
链接 | 链接外部URL [alt](URL title) alt 是显示在屏幕上的连接名 | [谷歌](www.google.com) 谷歌 |
锚点 | 其实每个标题都是一个锚点,和THML的锚点# 类似[create an anchor](#anchors-in-markdown) | 比如最上面定义了一个目录可以回到目录 定义为: [回到目录](#目录) 详细介绍 |
有序列表 | 详细效果 | |
多级有序列表 | 详细效果 | |
无序列表 | 使用+,*,- 都可以表示 | 详细效果 |
复选框列表 | 详细效果 | |
表格 | ||
多级表格 | 多级表格 | |
diff语法 | 与代码高亮类似,替换代码类型为diff即可 | diff语法 |
表情 | GFM支持出入表情 | 输入不同的冒号符(两个冒号包围的字符)可以显示出不同的表情 官方查询 |
标题
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
普通文本
普通文本
单行文本
(在一行的开头加一个tab或者是4个空格)
hello world
文本块
文本块
文本块
文本块
文本块
文本块
文本块
锚点
功能/语法:
1. It downcases the string
2. remove anything that is not a letter, number, space or hyphen (see the source for how Unicode is handled)
3. changes any space to a hyphen.
4. If that is not unique, add "-1", "-2", "-3",... to make it unique
如上所示,对于标题为
#What is LaTeX?
正确的链接方式是
[What is LaTeX?](#what-is-latex)
同理:[Ready, set, GO!](#ready-set-go)
使用这样的方式就可以实现Markdown的目录了。
多级表格
第一步:从word或excel中复制表格
第二步:打开此链接
第三步:贴上复制的文字,然后按convert,就会得到这个表格的代码:
第四步: 将代码粘贴到markdown中就可以显示出来
有序列表
格式为数字+ 英文符号. +空格 +名称
来表示
注意.
后面的空格
- 第一
- 第二
- 第三
多级有序列表
相同与有序列表,只要错开即可
注意.
后面的空格
- 第一
- 第二
- 第三
- 第二
无序列表
注意空格分隔开
+ 1
+ 2
+ 3
- 1
- 2
* 1
* 2
1
2
3
1
2
1
2
复选框
- 1
- 2
- 3
注意空格隔开
- [x] 1
- [x] 2
- [ ] 3
diff语法
GFM中可以 显示 diff效果,绿色表示新增,红色表示删除
+ 新增加
- 新删除