本篇文章的定位是掌握markdown的大致所有的语法(非扩展版本的),如果想要涉猎更加高妙的用法,例如快捷键等等,请参见beautiful markdown.
本篇文章的参考资料源于此处。
# heading level1
## heading level2
### heading level3
#### heading level4
##### heading level5
###### heading level6
NOtice:标题与正文之间需要保持一行的空格
语法规范:并且一级标题下面里面需要有二级标题,才能使用正常的标题
要创建段落,请使用空白行将文本分割。
比如这样,与上一句话实现了分割。
注意,不要这样:
//使用缩进Tab,空格Space都无效
I like math//其实并没有实际效果!在预览种无效果
如果你想实现换行而不是新建一个段落,你可以执行的操作:
//way1
I like math. //两个空格+换行
and I like English.
//way2
I like math.<br>//使用html的标签
and I like English.
Markdown | Html | Preview |
---|---|---|
I just love **bold text** |
I just love <strong>bold text</strong> |
I just love bold text |
Markdown | Html | Preview |
---|---|---|
A *cat* meow |
A <em>cat</em> meow |
A cat meow |
Markdown | Html | Preview |
---|---|---|
I like ***markdown*** |
I like <strong><em>markdown</em></strong> |
I like markdown |
>Whatever happened,I like markdown!
预览效果如下:
Whatever happened,I like markdown!
//如果引用块需要包含多个段落,可以在句子之间添加一个“>”
>I like markdown!
>
>who like markdown except you!
预览效果如下:
I like markdown!
who like markdown except you!
//如果是嵌套引用,可以在需要嵌套的句子前面添加一个“>>”
>I like markdown!
>
>>who like markdown except you!
预览效果如下:
I like markdown!
who like markdown except you!
//块引用 可以包含几乎所有的markdown元素
> - Revenue was off the chart.
> - Profits were higher than ever.
>
> *Everything* is going according to **plan**.
预览效果如下:
- Revenue was off the chart.
- Profits were higher than ever.
Everything is going according to plan.
Markdown | Html | Preview |
---|---|---|
1. first thing 2. second thing |
<ol><li>1. first thing </li><li>2. second thing</li></ol> |
1. first thing 2. second thing |
创建无序列表,可以使用减号(-)、加号(+)或者单星号(*)
Markdown | Html | Preview |
---|---|---|
- First thing |
<ul><li>First thing </li></ul> |
- First thing(表格内无法预览) |
预览效果入下:
注意事项:你需要在文本和这种语法句子之间保持空行,以免报错!
一般地,在vscode里面不会使用(*)(+),而是使用(-)来创建无序列表。
不再过多展示,因为这个真的不要太简单!
Markdown | Html | Preview |
---|---|---|
I type,supported by `markdown` |
I type,supported by <code>markdown</code> |
I type,supported by markdown |
详情请点开本文档的源代码,查看上面的代码。上面的代码使用了转义反引号。
//```(这里添加编程语言)
//多行代码内容
//```
//可以使用的分割线
***
---
______//推荐,下划线
预览效果如下:
Hello,
World!
Markdown | Html | Preview |
---|---|---|
这是一个链接 [Markdown语法](https://markdown.com.cn)。 |
<a href="超链接地址" title="超链接title">超链接显示名</a> |
这是一个链接 Markdown语法。 |
//<https://markdown.com.cn>
//<fake@example.com>
预览效果如下:
https://markdown.com.cn
fake@example.com
//I love supporting the **[EFF](https://eff.org)**.
//This is the *[Markdown Guide](https://www.markdownguide.org)*.
//See the section on [`code`](#code).
//要将链接表示为代码,请在方括号中添加反引号。
预览效果如下:
I love supporting the EFF.
This is the Markdown Guide.
See the section on code
.
//链接的第一部分,注意之间需要一个空格(VScode)
[name] [label1]
//裂解的第二部分
//一般会放在段落的末尾或者md文档的末尾
[label1]:https://www.markdownguide.org
预览效果如下
[markdownguide] 1
Markdown | Html | Preview |
---|---|---|
![图片alt](图片链接 “图片title”) |
<img src="picture link" alt="picture alt(format)" title="name" > |
略 |
在VScode中,直接把图片复制粘贴在这里就可以,不需要自己手码。
//格式参考如下:
[![图片alt](图片链接 “图片title”)](网址链接)
预览效果如下:
要显示原本用于格式化markdown文本的符号,一般使用反斜杠(\)
下面列出可以转义的符号:
|\
|*
|_
|{}
|[]
|()
|#
|+
|-
|.
|!
|
在Html文件中,常常对<
和&
两个符号进行特殊处理,如果你只想要使用这些符号,那么你必须使用实体的形式
像是<
和&
原因是,<
常常用作起始标签,&
用于标记Html实体。
即使你在markdown中没有用实体的形式写,它也会自动将两个符号转义为html的实体形式
因为VScode并没有内嵌Html标签,语法系统不支持,所以略去,详情见Markdown 内嵌html标签
| Syntax | Description |
| ----------- | ----------- |//使用三个或多个连字符(---)创建每列的标题
| Header | Title |
| Paragraph | Text |
预览效果如下:
Syntax | Description |
---|---|
Header | Title |
Paragraph | Text |
| Syntax | Description | Test Text |
| :--- | :----: | ---: |
| Header | Title | Here's this |
| Paragraph | Text | And more |
//左对齐 中间对齐 右对齐
预览效果如下:
Syntax | Description | Test Text |
---|---|---|
Header | Title | Here's this |
Paragraph | Text | And more |
Here's a simple footnote,[^1] and here's a longer one.[^bignote]
[^1]: This is the first footnote.
[^bignote]: Here's one with multiple paragraphs and code.
预览效果如下:
Here's a simple footnote,[1] and here's a longer one.[2]
~~世界是平坦的。~~ 我们现在知道世界是圆的
预览效果如下
世界是平坦的。 我们现在知道世界是圆的;
这个可以方便回访文档的任何一个部分,值得一学。
### My Great Heading {#custom-id}
预览效果如下:(配合链接使用)
go back to beginning
- [x] Write the press release
- [ ] Update the website
- [ ] Contact the media
预览效果如下:
还有一部分本文档并没有涉及,比如markdown的emoji使用等,此处可以参考Markdownguide