markdown语法


作者 李明明
转载请注明出处: http://limingming.org/index.php/2018/11/28/markdown-grammar/

介绍

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— 维基百科;
Markdown 是一种轻量级标记语言,让写作者专注于写作而不用关注样式。很多有编程基础的程序员比较喜欢使用Markdown进行编写,github项目中README.md都是markdown编写的;以下我讲述通用的语法,保留各个编辑器通用的,还有很多markdown语法是各个编辑器独有的,大家使用过程中可以注意一下,平时使用mac上的编辑器,也为大家分享一下。

语法介绍

标题

一级标题

二级标题

三级标题

演示图效果:

强调

  1. 在Markdown中,可以使用 * 或 _ 来表示斜体和加粗。
  2. 使用一个或者_来表示斜体,两个或者_来表示加粗。
A: *我是斜体*
B:  _我也是斜体_
C:**我是粗体**
D: __我也是粗体__

演示图效果:

  1. 例子(摘抄于马克飞象"案例,马克飞象是一个很不错的markdown编辑器,为markdown各种类型的语法提供了一个良好的支持)
**马克飞象**是一款专为印象笔记(Evernote)打造的Markdown编辑器,通过精心的设计与技术实现,配合印象笔记强大的存储和同步功能,带来前所未有的书写体验。特点概述:
 
- **功能丰富** :支持高亮代码块、*LaTeX* 公式、流程图,本地图片以及附件上传,甚至截图粘贴,工作学习好帮手;
- **得心应手** :简洁高效的编辑器,提供[桌面客户端][1]以及[离线Chrome App][2],支持移动端 Web;
- **深度整合** :支持选择笔记本和添加标签,支持从印象笔记跳转编辑,轻松管理。

锚点

markdown会针对每个标题,在解析时都会添加锚点 id,例如:

# 介绍
# 介绍1
那我们就可以使用“[访问介绍标题的锚点](#介绍)”,来定义锚点

测试:
访问介绍标题的锚点;

引用

Markdown 标记区块引用和 email 中用 『>』的引用方式类似,只需要在整个段落的第一行最前面加上 『>』 :

> 我是引区的内容,原来一直在CSDN编写博客[我的博客](https://blog.csdn.net/limm33)
我的微信公众号:[编程者联盟](https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
我的 [个人博客](http://www.limingming.org)
我的QQ群:115402375

演示:

列表

标记通常放在句子最左边,项目标记后面要接一个字符的空格。

  1. 无序列表:使用星号、加号或是减号作为列表标记
* 我是无序列表A 
+ 我是无序列表B 
- 我是无序列表C 

  1. 有序列表:使用数字接着一个英文句点
1. 我是无序列表1
2. 我是无序列表2 
3. 我是无序列表3

3.代办列表(简书暂不支持此方式)

- [ ] 不勾选
- [x] 勾选
  1. 补充
    如果在列表中使用引用,需要换行缩进,一般为四个空格:
*  演示内容:
    > 引用部分1
    > 引用部分2
    > 引用部分3
    > 引用部分4

代码块

使用`包裹代码块,并声明代码块的语言,一般会带有相关的解析插件,对代码进行高亮处理,对代码进行着色。

    ```java
		if (!chatBotMap.containsKey(sessionId)) {
			chat = aimlBot.setChat(sessionId);
			chatBotMap.put(sessionId, chat);
			answer = chat.multisentenceRespond(request);
		} else {
			chat = chatBotMap.get(sessionId);
			answer = chat.multisentenceRespond(request);
		}
      ```

演示:

超链接

方括号显示说明,圆括号内显示网址, Markdown 编辑器会自动把它转成链接;

[我的博客](https://blog.csdn.net/limm33)
[编程者联盟](https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
[个人博客](http://www.limingming.org)

演示:

图片

图片和超连接语法比较像,可以在方括号前面加一个!就变成了引用图片了;

![编程者联盟](url)
  或者:
![卡卡西](/Users/limm/Pictures/火影忍者/30381-106.jpg)
 相对路径也可以(./path/*.jpg)这种形式

分割线

使用 3 个以上 - 符号制作分割线:

分割线以上内容
------------------
分割线以下内容

演示:

表格

markdown可以制作表格,方法也很简单
例如:

3 | 3 | 3
-|-|-
3| 3| 3

以上为最基本的结构,‘3’代表你编辑的内容,第一行为表头,但是有的编辑器 - 需要多个,有的需要至少三个,所以布局可以尽量美观:

一列    |   第二列    | 第三列
---------|---------------|----------
  值1   |    值2        |   值3

演示:

可以设置对齐方式,使用 :添加在列的左边左对齐,右边为右对齐,两边都添加就是中间对齐:

一列    |   第二列    | 第三列
:---------|---------------:|:----------:
  值1   |    值2        |   值3
  值3   |    值4        |   值5

演示:

以上为总结的markdown的语法,希望对你的编写有所帮助。

联系我

原来一直在CSDN编写博客我的博客
我的微信公众号:[编程者联盟] (https://github.com/limm33/ProgrammerLeague/blob/master/ProgrammerLeague.jpg)
我的 个人博客
我的QQ群:115402375

你可能感兴趣的:(杂谈)