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. 某某教授的论文,要认真标注好。

目录
相关文章
|
6月前
markdown常用语法--花括号(超详细)
markdown常用语法--花括号(超详细)
|
程序员 Windows
markdown的基本语法
markdown的基本语法
94 0
|
2月前
【LaTex、markdown】常用语法写出漂亮的blog
【9月更文挑战第9天】本文介绍了使用LaTeX和Markdown编写美观博客的方法。LaTeX方面,需定义文档类型、设置标题与作者,并利用特定命令处理文本格式、列表、数学公式、图片和超链接。Markdown则通过井号表示标题级别,使用星号或下划线标记文本,简化列表和公式的编写,并以直观方式插入图片和链接。两者均可通过合理布局提升博客的可读性和视觉效果。
|
3月前
Markdown使用HTML语法实现复杂表格
Markdown使用HTML语法实现复杂表格
148 1
|
3月前
|
资源调度
机器人学 markdown数学公式常用语法
本文提供了Markdown中数学公式的常用语法,包括行内公式、行间公式、基本运算、矩阵、微积分、大小比较、开根号、表格、角标、头顶标、空格、括号、特殊字符、分式、文字、希腊字母以及分类括号的详细使用方法和示例。
60 1
|
4月前
|
自然语言处理 开发者 Python
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的 HTML 内容。Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强。
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的 HTML 内容。Markdown 的语法简洁明了、学习容易,而且功能比纯文本更强。
|
4月前
|
JavaScript
vue 加载展示md文件(markdown语法 .md后缀的文件)
vue 加载展示md文件(markdown语法 .md后缀的文件)
771 0
揭秘Markdown:轻松掌握基础语法,让你的写作更高效、优雅!
揭秘Markdown:轻松掌握基础语法,让你的写作更高效、优雅!
|
5月前
markdown语法
学习Markdown基本语法:标题、段落、强调、列表、代码块等,轻松撰写整洁文档。[查看教程](https://markdown.com.cn/basic-syntax/)
46 0
|
6月前
Markdown基础语法详细版
Markdown基础语法详细版