经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置:技术经验 » HTML/CSS » Markdown » 查看文章
Markdown 语法文档
来源:cnblogs  作者:__Light  时间:2019/4/26 8:36:32  对本文有异议

前言

Markdown 是一种轻量级标记语言,创始人为約翰?格魯伯(英语:John Gruber);

它允许人们 “使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者 HTML)文档”;

这种语言吸收了很多在 电子邮件中已有的纯文本标记的特性;

—— 维基百科

Markdown 的部分标记有几种不同的符号,但是实现的效果都是相同的,所以文章中每种实现的效果我只写一种符号,一般都是方便且较常用的标记符号;


标题

  1. # H1
  2. ## H2
  3. ### H3
  4. #### H4

# 的数量代表标题的级别;


段落与格式

段落

  1. 我是第一段
  2. 我是第二段

段落之间加入空行实现换行效果,如无空行,换行符会转换成空格;

  1. 我是第一段
  2. 我是第二段

在前一段落末尾加上至少两个空格,也可实现换行;

字体格式

  1. *斜体字体*
  2. **加粗字体**
  3. ***加粗斜体***

段落两端加上对应数量 *(星号),即可实现以上三种效果;

删除线

  1. ~~删除线~~

段落两端加上 ~~ 即可实现 删除线 效果;

下划线

  1. <u>下划线</u>

Markdown 语言中没有 下划线 标记,但是 Markdown 支持 HTML 标记,所以可以通过 HTML 的 <u> 标记实现 下划线 效果;


引用

引用内容

  1. >时间就是生命,我的朋友

时间就是生命,我的朋友

多行引用

  1. >多行引用如果需要换行
  2. >可在两行之间添加空行
  3. >
  4. >或在换行前的行末添加两个空格

多行引用如果需要换行
可在两行之间添加空行

或在换行前的行末添加两个空格

嵌套引用

  1. >时间就是生命,我的朋友
  2. >>Yes

时间就是生命,我的朋友

Yes!


列表

有序列表

  1. 1. 列表一
  2. 2. 列表二
  3. 1. 子列表一
  4. 2. 子列表二
  5. 3. 列表三
  1. 列表一
  2. 列表二
    1. 子列表一
    2. 子列表二
  3. 列表三

无序列表

  1. - 第一种实现符号
  2. + 第二种实现符号
  3. + 嵌套列表
  4. + 嵌套列表
  5. * 第三种实现符号
  • 第一种实现符号
  • 第二种实现符号
    • 嵌套列表
    • 嵌套列表
  • 第三种实现符号

TODO 列表

  1. - [ ] TODO 1
  2. - [ ] TODO 2
  3. - [ ] TODO 2.1
  4. - [x] TODO 2.2
  5. - [x] TODO 3

TODO

博客园暂不支持 TODO 列表;


代码

行内代码

  1. 全选:`Ctrl` + `A`

全选:Ctrl + A

代码块

  1. ?```
  2. 我是代码块
  3. ?```
  1. 我是代码块

注:1、3 行的 ``` 就是代码块的实现符号;

代码高亮

  1. ?```C#
  2. using System;
  3. class Markdown{ }
  4. ?```
  1. using System;
  2. class Markdown{ }

注:在行首 ``` 后加上代码语言的名字,即可实现对应的代码高亮;


邮箱

  1. <address@email.com>

address@email.com


链接

内联链接

  1. [Light's Note](https://www.cnblogs.com/Light-/ "Light's Note(可选)")

Light's Note

  1. <https://www.cnblogs.com/Light-/>

https://www.cnblogs.com/Light-/

外联链接

  1. [Light's Note][blog_Url]
  2. [blog_Url]:https://www.cnblogs.com/Light-/ "Light's Note(可选)"

Light's Note


图片

内联图片

  1. ![我的头像](https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Ligth's Note(可选)")

我的头像

外联图片

  1. ![我的头像][png_url]
  2. [png_url]:https://pic.cnblogs.com/avatar/1645312/20190418233348.png "Light's Note(可选)"

我的头像


表格

使用 | 分隔单元格,- 分隔表头和其他行;

  1. 表头 | 表头
  2. ----- | -----
  3. 单元格 | 单元格
  4. 单元格 | 单元格
表头 表头
单元格 单元格
单元格 单元格

单元格对齐

:- :左对齐

:-: :居中

-: :右对齐

  1. 表头 | 表头 | 表头
  2. :---- | :-: | ----:
  3. 左对齐 | 居中 | 右对齐
  4. 左对齐 | 居中 | 右对齐
表头 表头 表头
左对齐 居中 右对齐
左对齐 居中 右对齐

高级技巧

HTML 标记

Markdown 是一种标记语言,且同时兼容另一种标记语言 HTML (博客园暂只支持部分简单标记),所以我们也可以直接在文档中使用相关标记,例如:

<u> 下划线

  1. <u>下划线文本</u>

下划线文本

<kbd> 键盘框

  1. 全选:<kbd>Ctrl</kbd> + <kbd>A</kbd>

全选:Ctrl + A(博客园暂不支持)

<i> 内嵌图标

  1. <i class="icon-weibo"></i>

更多的图标和玩法可以参看 font-awesome 官方网站;(博客园暂不支持)

转义字符

Markdown 的占用了很多常用符号,如:*-~

如果我们写文档时需要显示这些符号,可以使用转义字符:\标记符号 转义为 普通符号 显示出来;

  1. *斜体文本*
  2. \*斜体文本\*

斜体文本
*斜体文本*

  1. **加粗文本**
  2. \*\*加粗文本\*\*

加粗文本
**加粗文本**

分隔符

  1. ---

使用至少三个 - (减号),加上一个空行,实现分隔符;

脚注

  1. Light's Note 里面的文章真棒![^脚注标题]
  2. [^脚注标题]: 是的,我也这么觉得~

Light's Note 里面的文章真棒!1


  1. 是的,我也这么觉得~?

原文链接:http://www.cnblogs.com/Light-/p/Markdown.html

 友情链接:直通硅谷  点职佳  北美留学生论坛

本站QQ群:前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

W3xue 的所有内容仅供测试,对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接(目前9元/月)请联系QQ:27243702 沸活量
皖ICP备17017327号-2 皖公网安备34020702000426号