关于Markdown使用方法及细则

Markdown基本使用准则

Markdown优势及使用场景

Markdown是一种轻量级标记语言,排版语法简洁,让人们更多地关注内容本身而非排版。它使用易读易写的纯文本格式编写文档,可与HTML混编,可导出 HTML、PDF 以及本身的 .md 格式的文件。因简洁、高效、易读、易写,Markdown被大量使用,如Github、Wikipedia、简书等。

————————————————————————————————————————————————————————————

Markdown基本语法:

1.标题语法:

(1) “ # ” + “空格(Space ” +“String” 可创建标题,根据“ # ”的数量可确定标题大小,标题一共分为六级,如图所示:

image-20220228195744341

ps: “ # ”必须接“空格(Space)再接内容,才能表示标题

(2) 对于Markdown文件,可以用任意数量的 == 号来标识一级标题,或者 – 号来标识二级标题,如图所示:

image-20220228195940969

ps:利用下划线标记标题,仅作用于一级标题或二级标题

2.段落语法:

(1)创建段落,请使用空白一行或者多行文本进行分隔

(2)不要用“空格(Space)”或“制表符(tabs)”缩进段落

3.换行语法:

(1)在一行的末尾添加两个或多个空格,然后按回车键,即可创建一个换行

(2)很多Markdown应用程序都支持结尾换行,但结尾换行也有缺陷,即,很难直观在编辑器上面看到空格,所以可以尝试使用HTML标签 <“br”>,当然在其他应用中也有不一样的换行方式如:CommonMark利用反斜杠(\)实现换行等

4.强调语法:

(1)粗体(Blod):要加粗文本,请在单词或短语的前后各添加两个星号(asterisks)或__下划线__(underscores)。如需加粗一个单词或短语的中间部分用以表示强调的话,请在要加粗部分的两侧各添加两个星号(asterisks)[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-d9iUeEl3-1646132387766)(C:\Users\24151\AppData\Roaming\Typora\typora-user-images\image-20220228203356491.png)]

ps:Markdown 应用程序在如何处理单词或短语中间的下划线上并不一致。为兼容考虑,在单词或短语中间部分加粗的话,请使用星号(**)

(2)斜体(Italic):要用斜体显示文本,请在单词或短语前后各加一个星号(*)或下划线(_),要求斜体突出单词中间部分,请在字母前后各加一个星号,且中间不要带空格

ps:要同时用粗体和斜体突出显示文本,请在单词或短语的前后各添加三个星号或下划线。要加粗并用斜体显示单词或短语的中间部分,请在要突出显示的部分前后各添加三个星号,中间不要带空格。

5.引用语法:

(1)创建块引用,请在段落前添加一个“ > ” 符号(>前面需要添加“\”),例如:

You can’t stop her from moving on to someone better

(2)块引用可以包含多个段落。为段落之间的空白行添加一个“ > ”

(3)嵌套块引用:块引用可以嵌套,要在嵌套的段落前添加一个“>>”符号------

(4)块引用可以包含其他Markdown格式的元素,但并非所有元素都可以使用

6.列表语法:

(1)有序列表:
要创建有序列表,请在每个列表前添加数字并紧跟一个英文句点“.”。数字不必按数学顺序排列,但是列表应当以数字1起始

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

  • First item
  • Second item

(3)在列表中嵌套其他元素:

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

段落

  • This is the first list item

  • Here‘s the second list item

    I need to add another paragraph below the second list item

  • And here’s the third list item

引用块

  • This is the first list item

  • Here‘s the second list item

    I need to add another paragraph below the second list item.

  • And here’s the third list item

代码块

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

  1. Open the file

  2. Fine the following code block on line 21:

    	<head>
            <title>Test</title>
    	</head>
    
  3. Update the title to match the name of your website.

图片 (略,详见***10.图片语法***)

列表

  1. First item

  2. Second item

  3. Third item

    • Indented item

7.代码语法:

标记代码

要将单词或短语表示为代码,请将其包裹在反引号(`)

  • At the command prompt,type nano.

转义反引导

如果你要表示为代码的单词或短语中包含一个或多个反引导,则可以通过将单词或短语包裹在双反引导(``)中

  • Use `code` in your Markdown file.

代码块

要创建代码块,请将代码块的每一行缩进至少四个空格或一个制表符

<head>
    
</head>

ps:要创建不用缩进的代码块,请使用围栏式代码块(fenced code blocks).

8.分割线语法:

分割线

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

9.链接语法:

***超链接Markdown语法代码:***[超链接显示名](超链接地址“超链接title”)

***对应的HTML代码:***超链接显示名a>

***网址和Email地址:***使用尖括号可以很方便的吧URL或者email地址变成可点击的链接<地址>

带格式化的链接: 强调 链接,在链接语法前后增加星号,若需要将链接表示为代码,请在方括号中添加反引号

  • 请给我的博客点个**关注**

10.图片语法:

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

插入图片的Markdown语法代码:![图片alt] (图片链接"图片tiltle")

对应的HTML代码:<img src=“图片链接” alt="图片alt” tiltle=“图片title”>

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

11.转义字符语法:

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

可做转义的字符:

(\)( `)(*)(_)({})([])(())(#)(+)(-)(.)(!)(|)、

lt” tiltle=“图片title”>

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

11.转义字符语法:

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

可做转义的字符:

(\)( `)(*)(_)({})([])(())(#)(+)(-)(.)(!)(|)、

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值