首页 > 其他分享 >markdown

markdown

时间:2023-03-03 10:59:13浏览次数:45  
标签:markdown HTML level 链接 添加 Markdown heading

Markdown 学习笔记

Markdown 标题(title)

# heading level 1
## heading level 2
### heading level 3
#### heading level 4
##### heading level 5
###### heading level 6

heading level 1

heading level 2

heading level 3

heading level 4

heading level 5
heading level 6

可以在文本下方添加任意数量的==号来标识一级标题,或者--号来标识二级标题

heading level 1
===
heading level 2
---

heading level 1

heading level 2

Markdown 段落(Paragraph)

要创建段落,使用空白行将一行或者多行文本进行分隔。

空白行可以分为两个段落

段落不要用空格(spaces)和制表符(tabs)

Markdown 换行语法

在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行
也可以使用HTML的 <br> 标签来实现换行

第一行<br>第二行

第一行
第二行

换行与段落的区别在于换行后两行是挨着的,而段落之间有一个空行。

Markdown 强调语法

粗体(Bold)

要加粗文本,需要在短语的前后各添加两个星号(asterisks)或下划线(underscores)。如果需要加粗一个单词或者短语的中间部分用以表示强调的话,则需要在加粗部分的两侧各添加两个星号(asterisks)。

**test**

test

推荐使用星号

斜体(Italic)

要用斜体显示文本,需要在单词或短语前后添加一个星号(asterisks)或者下划线(underscore)。要是斜体单词在中间部分,则需要在字母前后各添加一个星号,中间不要带空格。

*test*

test

如果需要同时粗体和斜体,则可以在单词或短语的前后各添加三个星号或下划线。推荐使用星号。

Markdown 引用语法

创建块引用,需要在段落前添加一个 > 符号

引用test

块应用可以包含多个段落。为段落之间的空白行添加一个 > 符号

嵌套块引用

在需要嵌套的段落前添加一个 >> 符号

>first
>>second

first

second

带有其他元素的块引用

可以引用其他块元素,如无序列表。

Markdown 列表语法

有序列表

要创建有序列表,需要在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列,但是列表应当以数字1开始。

1. First 
    1. first
2. Third
  1. First
    1. first
  2. Third
    1. 2.1

无序列表

创建无需列表,可以在每个列表前面添加破折号(-),星号(*),加号(+)。缩进一个或多个列表项可创建嵌套列表。

建议选择一个只用即可。

- 1
- 2
  • 1
  • 2

在列表中嵌套其他元素使用

要么保留列表连续性的同时在列表中添加另一种元素,请将该元素缩进四个空格或一个制表符。

* The first list item.
    the middle of the list
* The second list item.
  • The first list item.
    the middle of the list
  • The second list item.
    并且可以添加引用块。

代码块

代码块通常采用四个空格或一个制表符缩进。当它们被放在列表中时,请缩进为八个空格或者两个制表符。

图片

同图片格式

列表

可以在列表中嵌套

代码

如果要将单词或者短语表示为代码,请将其包括在反引号内 test

转义反引号

如果需要表示为代码的单词或短语中包含一个或者多个反引号,则可以通过将单词或短语包括在双反引号中

``show the `sym` symbol``

show the `sym` symbol

代码块

创建代码块,将代码块的每一行至少缩进四个空格或一个制表符,即可创建为代码块。

<html>
 <head>
 </head>
</html>

Markdown 分隔线语法

创建分隔线,请在单独一行上使用三个或多个星号(***),破折号(---),或者下划线(___),并且不能包含其他内容。

---

为了兼容性,在分隔线前后均添加空白行。

Markdown 链接语法

链接文本放在中括号中,链接地址放在后面的括号中,链接title可选。超链接Markdown语法
代码 : [ 超链接显示名 ]( 超链接地址"超链接title" )

给连接增加title

链接title是当鼠标悬停在链接上时会出现的文字,这个title是可选的,它放在圆括号链接地址后面,跟链接地址之间以空格分隔。

这是一个链接 [Markdown语法](https://markdown.com.cn "最好的markdown教程")。

这是一个链接 Markdown语法

网址和Email地址

使用尖括号可以很方便地把URL或者Email地址变成可点击的链接。

<https://markdown.com.cn>

https://markdown.com.cn

带格式化的链接

强调链接,在链接语法前后增加星号。要将链接表示为代码,请在方括号中添加反引号。

test website **[Markdown Guide](https://www.markdownguide.org)**.
this is the code format [`code`](#code).

test website Markdown Guide.
this is the code format code .

引用类型链接

引用样式链接是一种特殊的链接,它使URL在markdown中更易于显示和阅读。参考样式链接分为两部分:与文本保持内联部分以及存储在文件中其他位置的部分,以使文本抑郁阅读。

链接的两个部分

引用类型的链接的第一部分是用两组括号进行格式设置。第一组方括号包围显示为链接的文本。第二组括号显示一个标签,该标签用于指向你存储在文档其他位置的链接。

尽管不是必需的,但推荐在第一组和第二组括号之间包含一个空格。第二组括号中的标签不区分大小写,可以包含字母,数字,空格和标点符号。

[title][id]

简而言之呢,就是给需要引用链接处再添加一个id,在最后用id添加需要引用的链接。

[id]: the website 

即下面这种方式也可以实现引用链接,使代码可读性更好。

[Markdown guide][1]

[1]: https://www.markdownguide.org 

Markdown guide

这样可以使Markdown代码的可读性提高。

推荐使用%20代替空格

[link](https://www.example.com/my%20great%20page)

图片

要添加图像,请使用感叹号 (!) ,然后在方括号增加替代文本,图片链接放在圆括号里,括号里的链接后可以增加一个可选的图片标题文本。

![这是图片](https://ts1.cn.mm.bing.net/th/id/R-C.24d24538ef5d99a30ee76b0fdc3e3f6e?rik=bHaWIJt%2b%2fpQtNQ&riu=http%3a%2f%2fup.kukudesk.com%2fpic%2f07%2f45%2ffe%2f0745fe688ec109f8fba6c8ce0932947c.jpg&ehk=ieklOkJv9MVov9Umh3oJOyuEwmE8oZjAB14zFmXKwbo%3d&risl=&pid=ImgRaw&r=0 "鲸鱼")

这是图片

链接图片

给图片增加链接,请将图像内的Markdown阔在方括号中,然后将链接添加在圆括号中。

[![霍尔斯滕门](https://ts1.cn.mm.bing.net/th/id/R-C.cd3cd83331d383396097649f0a46dd0c?rik=CAcigi3sQuQvMw&riu=http%3a%2f%2fdimg02.c-ctrip.com%2fimages%2f100w070000002efzlC0F9.jpg&ehk=j6L2zu3yg5P862KTXKBQM9xVf1ozUir8E3caP4LxuSg%3d&risl=&pid=ImgRaw&r=0 "霍尔斯滕门")](https://cn.bing.com/search?q=%e9%9c%8d%e5%b0%94%e6%96%af%e6%bb%95%e9%97%a8&form=hpcapt&filters=HpDate:%2220230228_1600%22)

霍尔斯滕门

转义字符语法

要显示原本用于格式化Markdown文档的字符,请在字符前面添加反斜杠字符\。

\*test\*

*test*

以下字符都可以使用反斜杠字符总而达到转移目的:\,`,*,_,[],{},(),#,+,-,.,!,|.

特殊字符自动转义

在HTML文件中,有两个字符需要特殊处理<,&,<符号用于起始标签,&用于标记HTML实体,如果你只是想要使用这些符号,那必须要使用实体的形式,像是&lt;,和&amp;

简而言之,Markdown允许你直接只用这两个符号,会帮你自动转移。但如果你使用&作为HTML实体的一部分,或者使用<作为HTML标签的分隔符,那Markdown将不会对其做任何转换,其他抢矿则会被转换。

Markdown内嵌HTML标签

对于Markdown涵盖范围之外的标签,都可以直接在文件里用HTML本身。如需要使用HTML,不需要额外标注这是HTML或是Markdown,只需要HTML标签添加到Markdown文本中即可。

行级内联标签

HTML的行级内联标签如<span>,<cite>,<del>不受限制,可以在Markdown的段落、列表或是标题里任意使用。

**bold**,<em>italic</em>

bold,italic

区块标签

区块元素比如,<div>,<table>,<pre>,<p>,等标签,必须在前后加上空行,以便于内容区分。

Markdown语法在HTML区块标签中将不会被进行处理。

如需要使用HTML标签的子集,请查看相应的Markdown应用程序的手册。

标签:markdown,HTML,level,链接,添加,Markdown,heading
From: https://www.cnblogs.com/kennem/p/17174751.html

相关文章

  • MarkDown学习
    MarkDown学习标题:二级标题三级标题四级标题字体Hello,World!斜体*(内容)*Hello,World!粗体**(内容)**Hello,World!粗体+斜体***()***Hello,World!删......
  • MarkDown笔记
    标题#标题名字(井号的个数代表标题的级数)一级标题使用1个#二级标题使用2个#三级标题使用3个#四级标题使4用个#五级标题使用5个#六级标题使用6个##最多支持六级标......
  • MarkDown使用
    MarkDown语法标题代表几级标题+空格+标题名字体样式加粗两侧家**倾斜两侧加*加粗倾斜两侧加***删除线两边加~~引用大于符号123123213分割线三个-三个......
  • Markdown学习
    Markdown学习标题字体Hello,worldHello,worldHello,worldHello,world引用引用分割线图片超链接我的博客列表1.A2.B3.CABC表格姓名性别......
  • Markdown学习
    Markdown学习标题一级标题:#+空格+标题名N级标题:N个#+空格+标题名字体字体两边+*=斜体这是斜体字体两边+**=粗体这是粗体字体两边+~~=删除......
  • Markdown 语法
    Markdown语法基本语法Markdown是一种轻量级的标记语言,可以用来编写格式简单、易读易写的文本。Markdown语法简单易懂,学习成本低,因此广受欢迎。下面是Markdown基本语......
  • 什么是Markdown
    什么是markdown?Markdown是一种轻量级标记语言,它允许人们使用已读一些的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯......
  • atom 安装markdown-preview-enhanced插件
    atom自带markdown的支持,但是不够智能,例如每个md文件都要手动打开预览,这个插件切换文件的时候,也会自动切换预览。install插件​​markdown-preview-enhanced​​ctrl+shi......
  • VScode+Markdown+PicGo
    在Vscode上写Markdown代码,并且用PicGo上传图片。以下内容有Markdown插件OfficeViewer,所见即所得。注意此插件的编辑模式下不能使用PicGo扩展,只有VS的普......
  • Markdown环境安装与导出PDF
    Markdown语言的特点,ChatGPT的回答如下:-------------Markdown是一种轻量级标记语言,它具有以下几个特点:简单易学:Markdown语言非常简单易学,语法简洁明了,可以在短时间内......