Markdown 语法文档
Markdown 语法文档
前言
Markdown 是一种轻量级标记语言,创始人为約翰・格魯伯(英语:John Gruber);
它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”;
这种语言吸收了很多在 电子邮件中已有的纯文本标记的特性;
—— 维基百科
Markdown 的部分标记有几种不同的符号,但是实现的效果都是相同的,所以文章中每种实现的效果我只写一种符号,一般都是方便且较常用的标记符号;
标题
# H1
## H2
### H3
#### H4
#
的数量代表标题的级别;
段落与格式
段落
我是第一段
我是第二段
段落之间加入空行实现换行效果,如无空行,换行符会转换成空格;
我是第一段
我是第二段
在前一段落末尾加上至少两个空格,也可实现换行;
字体格式
*斜体字体*
**加粗字体**
***加粗斜体***
段落两端加上对应数量 *
(星号),即可实现以上三种效果;
删除线
~~删除线~~
段落两端加上 ~~
即可实现 删除线 效果;
下划线
<u>下划线</u>
Markdown 语言中没有 下划线 标记,但是 Markdown 支持 HTML
标记,所以可以通过 HTML 的 <u>
标记实现 下划线 效果;
引用内容
单行引用
>时间就是生命,我的朋友
时间就是生命,我的朋友
多行引用
>多行引用如果需要换行
>可在两行之间添加空行
>
>或在换行前的行末添加两个空格
多行引用如果需要换行
可在两行之间添加空行或在换行前的行末添加两个空格
嵌套引用
>时间就是生命,我的朋友
>>Yes!
时间就是生命,我的朋友
Yes!
列表
有序列表
1. 列表一
2. 列表二
1. 子列表一
2. 子列表二
3. 列表三
- 列表一
- 列表二
- 子列表一
- 子列表二
- 列表三
无序列表
- 第一种实现符号
+ 第二种实现符号
+ 嵌套列表
+ 嵌套列表
* 第三种实现符号
- 第一种实现符号
- 第二种实现符号
- 嵌套列表
- 嵌套列表
- 第三种实现符号
TODO 列表
- [ ] TODO 1
- [ ] TODO 2
- [ ] TODO 2.1
- [x] TODO 2.2
- [x] TODO 3
博客园暂不支持 TODO 列表;
代码
行内代码
全选:`Ctrl` + `A`
全选:Ctrl
+ A
代码块
```
我是代码块
```
我是代码块
注:1、3 行的 ```
就是代码块的实现符号;
代码高亮
```C#
using System;
class Markdown{ }
```
using System;
class Markdown{ }
注:在行首 ```
后加上代码语言的名字,即可实现对应的代码高亮;
邮箱
<address@email.com>
链接
内联链接
[Light's Note](https://www.cnblogs.com/Light-/ "Light's Note(可选)")
<https://www.cnblogs.com/Light-/>
https://www.cnblogs.com/Light-/
外联链接
[Light's Note][blog_Url]
[blog_Url]:https://www.cnblogs.com/Light-/ "Light's Note(可选)"
图片
内联图片
![我的头像](https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Ligth's Note(可选)")
外联图片
![我的头像][png_url]
[png_url]:https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Light's Note(可选)"
表格
使用 |
分隔单元格,-
分隔表头和其他行;
表头 | 表头
----- | -----
单元格 | 单元格
单元格 | 单元格
表头 | 表头 |
---|---|
单元格 | 单元格 |
单元格 | 单元格 |
单元格对齐
:-
:左对齐
:-:
:居中
-:
:右对齐
表头 | 表头 | 表头
:---- | :-: | ----:
左对齐 | 居中 | 右对齐
左对齐 | 居中 | 右对齐
表头 | 表头 | 表头 |
---|---|---|
左对齐 | 居中 | 右对齐 |
左对齐 | 居中 | 右对齐 |
高级技巧
HTML 标记
Markdown 是一种标记语言,且同时兼容另一种标记语言 HTML
(博客园暂只支持部分简单标记),所以我们也可以直接在文档中使用相关标记,例如:
<u> 下划线
<u>下划线文本</u>
下划线文本
<kbd> 键盘框
全选:<kbd>Ctrl</kbd> + <kbd>A</kbd>
全选:Ctrl + A(博客园暂不支持)
<i> 内嵌图标
<i class="icon-weibo"></i>
更多的图标和玩法可以参看 font-awesome 官方网站;(博客园暂不支持)
转义字符
Markdown 的占用了很多常用符号,如:*
、-
、~
…
如果我们写文档时需要显示这些符号,可以使用转义字符:\
将 标记符号 转义为 普通符号 显示出来;
*斜体文本*
\*斜体文本\*
斜体文本
*斜体文本*
**加粗文本**
\*\*加粗文本\*\*
加粗文本
**加粗文本**
分隔符
---
使用至少三个 -
(减号),加上一个空行,实现分隔符;
脚注
Light's Note 里面的文章真棒![^脚注标题]
[^脚注标题]: 是的,我也这么觉得~
Light's Note 里面的文章真棒![1]
是的,我也这么觉得~ ↩︎
Markdown 语法文档的更多相关文章
- 嵌入式 H264参数语法文档: SPS、PPS、IDR以及NALU编码规律
// [h264编码出的NALU规律]// 第一帧 SPS[0 0 0 1 0x67] PPS[0 0 0 1 0x68] SEI[0 0 0 1 0x6] IDR[0 0 0 1 0x65]// p ...
- SQL 进阶视频课程。Udacity: Intro to Relational Databases和 PostgreSQL语法文档。
Udacity: Intro to Relational Databases The syntax of the select statement with a where clause: selec ...
- Smali 语法文档
可以选择保存成pdf格式,查询起来挺方便的 if v0==0 go cond_0 if-eqz v0, :cond_0 if v0!=0 go cond_0 if-nez v0, :cond_0 ...
- Markdown 语法和 MWeb 写作使用说明
---恢复内容开始--- # Markdown 语法和 MWeb 写作使用说明 Markdown 的设计哲学 Markdown 的目標是實現「易讀易寫」. 不過最需要強調的便是它的可讀性.一份使用 M ...
- Markdown语法和MWeb使用说明
Markdown 语法和 MWeb 写作使用说明 开始写博客,首先熟悉一下Markdown,以前过看GitHub里的README.MD,感受到了这种文字排版的简洁美观. 写博客是一种有效的学习总结和分 ...
- 怎样在Linux下使用Markdown进行文档工作
怎样在Linux下使用Markdown进行文档工作 在Linux系统中,编辑markdown能够用retext工具: sudo apt-get install retext retext Releas ...
- MARKDOWN使用文档
ISSUE引用 引用当前项目内的ISSUE #1 markdown写法 #1 引用当前命名空间下的其他项目内的ISSUE projectname#1 sofa_ta#1 markdown写法 sofa ...
- 如何写Markdown格式文档
Markdown Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯.它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档.这种语言吸收了很多在电子邮件中 ...
- 使用Markdown写文档
转载于:http://blog.csdn.net/xiahouzuoxin/article/details/19752603 Markdown是一种网络书写语言,其目标是实现易读易写,且兼容HTML语 ...
随机推荐
- 值得注意的CSS属性
文本TEXT letter-spacing 字符间距 word-spacing 字间距 line-height 行高 text-decoration 修饰(下划线) text-indent 首行缩进 ...
- python之six用法
six.PY2 返回一个表示当前运行环境是否为python2的boolean值 six.PY3 返回一个表示当前运行环境是否为python3的boolean值 import six,sys print ...
- ubuntu16.04开机循环输入密码无法进入桌面的解决办法
前些天碰到一个头疼的问题,启动我的ubuntu之后,输入密码闪屏一下,又需要输入密码!!!于是再输还要再输!!!!! 经过百度一翻后终于找到原因和解决办法. 原来是我之前在profile文件里配置了一 ...
- 测试网页时需要添加等待的情形 (Selenium)
测试网页时需要添加等待的情形: 1. 网页跳转 2. DOM结构发生改变.
- 比较集合List<T>集合,前后多了哪些数据,少了哪些数据Except
1.少了哪些数据 private List<int> GetRoleIdListReduce(List<int> roleIdListOld, List<int> ...
- bzoj 3126 单调队列优化dp
能转移的最左是其左边完整区间的最右左端点,最右是能覆盖它的最左左端点-1 #pragma GCC optimize ("O3") #include<cstdio> #i ...
- BZOJ_1031_[JSOI2007]字符加密Cipher_后缀数组
BZOJ_1031_[JSOI2007]字符加密Cipher_后缀数组 Description 喜欢钻研问题的JS同学,最近又迷上了对加密方法的思考.一天,他突然想出了一种他认为是终极的加密办法 :把 ...
- Pandas 错误笔记(持续更新)
更新至2018.5.1 字典生成DataFrame 今天一个字典生成一个DataFrame,采用了以下形式,每一个value都是一个数(不是vector) df = pd.DataFrame({ 'i ...
- Treap与fhq_Treap学习笔记
1.普通Treap 通过左右旋来维护堆的性质 左右旋是不改变中序遍历的 #include<algorithm> #include<iostream> #include<c ...
- 从YOLOv1到v3的进化之路
引言:如今基于深度学习的目标检测已经逐渐成为自动驾驶,视频监控,机械加工,智能机器人等领域的核心技术,而现存的大多数精度高的目标检测算法,速度较慢,无法适应工业界对于目标检测实时性的需求,这时YOLO ...