开发者社区> jorgezhong> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

markdown语法

简介:   学习markdown?当然是为了做做笔记,脑子不好就只能动动手指啦。   以往做笔记是用的OneNote,但是一段事件下来,发现记在OneNote上的东西非常多,而且不方便查找。
+关注继续查看

  学习markdown?当然是为了做做笔记,脑子不好就只能动动手指啦。
  以往做笔记是用的OneNote,但是一段事件下来,发现记在OneNote上的东西非常多,而且不方便查找。OneNote的Copy技能太强大了有木有。在现在日常开发节奏这么快的环境下,遇到不懂的技术基本都是度娘,google一顿操作,然后过两天忘了。悲哀呀,日常学习成果就这样遗忘在时间的角落了。本人表示很愤怒,本来就是我的,凭什么丢掉。
  脑子不好只有靠别的弥补了,于是有了学习 markdown 并撰写博客的动机了。给自己的学习增加一个知识整理的过程,一个技术沉淀的载体。


目录

[toc]


1:标题

标题有六个级别,用 # 号来表示,有以下六个级别。

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

2:列表

markdown中里列表也有“有序”和“无序”之分。
在文字前加上 - * + 就是无序列表,但是效果一样的,
加上数字如 1. 2. 3. 便是有序列表。
注:-、1. 和文本之间要保留一个字符的空格

- 无序列表1
- 无序列表2

* 无序列表1
* 无序列表2

+ 无序列表1
+ 无序列表2
  • 无序列表1
  • 无序列表2
  • 无序列表1
  • 无序列表2
  • 无序列表1
  • 无序列表2
1. 有序列表1
2. 有序列表2
  1. 有序列表1
  2. 有序列表2

3:表格

语法:

  • 列:用 | 区分每列。
  • 行:只能区分表头和表单内容,用 - 区分
  • 对齐:再相应的方向上,用 :表示,如:
    ----- 默认对其:左对齐
    ----: 为右对齐
    :---- 为左对齐
    :---: 为居中对齐
| column | column | column | column |
| ---: | :----: | :----- | ---- |
|   row  | row | row | row |
|   row  | row |     | row |
|   row  | row | row |     |

column column column column
row row row row
row row row
row row row

4:链接

markdown中链接有两种:参考式、行内式。
链接的话可以是本地资源路径,相对路径和绝对路径都是可以的

行内式语法:[显示文本](链接地址 "title")
链接弟子可以用<>包裹,也可以不用,效果式一样的
title属性的效果是鼠标悬浮到显示文本上会有提示信息,跟html是一样的。不想要的话,可以省略该属性。而属性值用单引号''、双引号“”、小括号()等任意一个符号包裹都是可以的,可以试一下。

参考式语法:
[显示文本][引用标识]
[引用标签]: 链接地址 "title"
参考式语法其实就是先定义好了再使用,多了个引用标签这样,方便我们集中管理引用,万一引用的资源url变了,方便修改了。
另外需要注意的是,参考式的链接地址和行内式的链接地址式不一样的,行内式的链接地址需要用小括号包裹,而参考式是不需要小括号的。

行内式链接(有title):[这是百度的链接](www.baidu.com "百度")
行内式链接(无title):[这是百度的链接](www.baidu.com)

行内式链接(符号:<>):[这是百度的链接](<www.baidu.com> "百度")
行内式链接(符号:''):[这是百度的链接](<www.baidu.com> '百度')
行内式链接(符号:()):[这是百度的链接](<www.baidu.com> (百度))

行内式链接(有title): 这是百度的链接
行内式链接(无title): 这是百度的链接
行内式链接(符号:''): 这是百度的链接
行内式链接(符号:""): 这是百度的链接
行内式链接(符号:()): 这是百度的链接

参考式链接:[这是百度的链接][mark-1]
参考式链接:[这是百度的链接][mark-2]
参考式链接:[这是百度的链接][mark-3]

[mark-1]: www.baidu.com "这是百度链接"
[mark-2]: www.baidu.com '这是百度链接'
[mark-3]: www.baidu.com (这是百度链接)

参考式链接:这是百度的链接
参考式链接:这是百度的链接
参考式链接:这是百度的链接


5:图片

markdown中图片也有两种:参考式、行内式。这和链接是一样的
路径的话可以是本地资源路径,相对路径和绝对路径都是可以的

行内式语法:[图片上传失败...(image-ef80a8-1535444198905)]
对比链接,也就多了个感叹号。

参考式语法:
![失效显示文本][引用标识]
[引用标签]: 图片地址 "title"
图片的参考式语法和链接的区别也是多了一个 ! 其他都是一样的。

行内式图片:
![这是百度的图片](http:https://yqfile.alicdn.com/img_2d8f060abfe954d3f513f3e2ec1b7b02.jpeg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240 "悬浮提示信息:message!!!")

行内式图片:


img_2d8f060abfe954d3f513f3e2ec1b7b02.jpe
这是百度的图片
参考式图片:
![这是百度的图片][mark-img-1]
![这是百度的图片][mark-img-2]

[mark-img-1]:http://e.hiphotos.baidu.com/zhidao/wh%3D450%2C600/sign=08ce1447ceef76093c5e919b1bed8ffa/622762d0f703918fa4d62d10543d269758eec4e0.jpg "这是百度的图片"
[mark-img-2]:https://yqfile.alicdn.com/img_2d8f060abfe954d3f513f3e2ec1b7b02.jpeg "这是百度的图片"

参考式图片:


这是百度的图片
这是百度的图片

这是百度的图片
这是百度的图片

建议:行内式和参考式其实更应该使用参考式,因为图片地址和链接地址这种东西都是非常长的字符串,嵌入到文本内容当中很不优雅,会用凌乱的感觉,而使用参考式则没有这个问题,另外还可以统一管理url地址。也不用担心引用标签重复的问题。


6:代码块

写技术博客,最常用到的就是代码引用,markdown用 ` 来表示引用代码。

语法:

  • `单行引用`
  • ``` 多行引用
    多行引用
    多行引用
    ```

单行代码引用:`LOGGER.info("message");`

多行代码引用:

@RunWith(SpringRunner.class)
@SpringBootTest
public class DemoApplicationTests {

    private static final Logger LOGGER = LoggerFactory.getLogger(DemoApplicationTests.class);

    @Test
    public void contextLoads() {

        LOGGER.info("message");

    }

}

7:区块引用

语法:用 > 来表示区块引用,有多少级就加多少个。只要是连续的,貌似没有限制。如果要另外增加相邻的同级,要空一行。

>一级引用
>>二级引用
>>>三级引用
>>>>四级引用
>>>>>五级引用

>>>>>>六级引用
>>>>>五级引用
>>>>>>>七级引用

>一级引用

一级引用

二级引用

三级引用

四级引用

五级引用

六级引用

五级引用

七级引用

一级引用


8:特殊字符

特殊markdown本质上其实是和html一样的语言,因此关于特殊字符和转移和html也是一样的,可以直接用编码展示特殊字符,参照HTML ASCII 参考手册

例如这些实体:
&#33;   &#34;   &#35;   &#36;   &#38;   &#60;   &#62;   &#169;  &#174;  &#165;

! " # $ & < > © ® ¥


9:分割线

分割线可以用三个以上的 *- 来表示。

------
被分割的内容
******

被分割的内容



10:文字处理

字体处理常用的就是高亮,颜色和加粗了,当然还有下划线,斜体,这些,删除一般都不会用了。颜色的话简书貌似也不支持,尚极简风格。不然的话可以用<font>标签来设置

  • 高亮:用 == 包裹,高亮简书不支持,建议用 ` 代替
  • 斜体:用 * 包裹
  • 加粗:用 ** 包裹
  • 下划线:用 ++ 包裹
  • 删除:用 ~~ 包裹
  • 段首空两格:用 &#8195;&#8195;
==高亮==
*斜体*
**加粗**
++下划线++
~~删线~~

&#8195;&#8195;段首空两格
段首空两格,段首空两格,段首空两格。

==高亮==
斜体
加粗
++下划线++
删线

  段首空两格
段首空两格,段首空两格,段首空两格。


11:生成目录

使用[toc]就可以了,但是简书不支持。有道和csdn是可以支持的。


12:参考文献

参考文献的表示方式叫脚注或者尾注
语法:[^标签]
其实这个标签只是代码方便查看而给予的一个自定义方式,最终呈现在文本上的都是按全篇顺序排好序的文献引用。而且参考文献里欸包会自动加载到文档最魔为,分隔符是无法分割的

XXXXX[^1] XXXXXXXXXXXXXXXX,
XXXXX[^hello] XXXXXXXXXXXXXXXX,
XXXXX[^正经引用] XXXXXXXXXXXXXXXX,
XXXXX[^大学论文] XXXXXXXXXXXXXXXX

[^1]: 一个很普通的参考文献。
[^hello]: 这个很可能是自己的原创。
[^正经引用]: 某个知名博主的发表吧,引用一下。
[^大学论文]: 某某教授的论文,要认真标注好。

XXXXX[1] XXXXXXXXXXXXXXXX,
XXXXX[2] XXXXXXXXXXXXXXXX,
XXXXX[3] XXXXXXXXXXXXXXXX,
XXXXX[4] XXXXXXXXXXXXXXXX



  1. 一个很普通的参考文献。

  2. 这个很可能是自己的原创。

  3. 某个知名博主的发表吧,引用一下。

  4. 某某教授的论文,要认真标注好。

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
Markdown基本语法
基本语法介绍
6 0
Markdown语法(一)
Markdown语法教程 官网教程: http://www.markdown.cn/#editor 博客: https://ouweiya.gitbooks.io/markdown/index.html 按下m,编程了纯文本格式,可以用markdown写文档了 md 一个井号是一级标题 三个井号是三...
1173 0
MarkDown语法解析
Markdown 的优点如下: 1.纯文本,所以兼容性极强,可以用所有文本编辑器打开。 2.让你专注于文字而不是排版。 3.格式转换方便,Markdown 的文本你可以轻松转换为 html、电子书等。
1040 0
MarkDown 语法手册
From: http://blog.leanote.com/post/freewalk/Markdown-%E8%AF%AD%E6%B3%95%E6%89%8B%E5%86%8C From: http://www.jianshu.com/p/1e402922ee32/ Markdown 是一种用来写作的轻量级「标记语言」,它用简洁的语法代替排版,而不像一般我们用的字处理软件 W
3081 0
Markdown语法大全
版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/qingfeng812/article/details/51281732 ...
831 0
Markdown基本语法
一级标题 语法:#一级标题 二级标题: 语法:##二级标题 三级标题: 语法:###三级标题 四级标题: 语法:###四级标题 五级标题: 语法:#####五级标题 六级标题: 语法:######六级标题 分割线: 语法:---- 斜体: 语法:*斜...
854 0
Markdown基本语法
 http://www.awolau.com/markdown/markdown-learn1.html   标题 在Markdown当中设置标题,有两种方式: 第一种:通过在文字下方添加“=”和“-”,他们分别表示一级标题和二级标题。
1103 0
+关注
文章
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载