首页 > 其他分享 >markdown基础语法

markdown基础语法

时间:2022-10-18 10:00:11浏览次数:68  
标签:空格 markdown HTML 代码 基础 列表 语法 Markdown 链接

markdown基础语法

1.标题

标题格式:#+空格+标题内容,如# 标题

2.段落

用空白行创建段落,例如:

对泉能自诫,如镜静相邻。

最佳实践: 
  不要用空格或制表符(tabs)缩进段落。用&nbsp和全角空格缩进。

3.换行

两种方式,一种是在结尾处输入多个空格(>=2),然后按回车换行;另一种方式是用html标签</br>实现换行。

4.强调

两种强调,一种是加粗,一种是斜体。
1)加粗
语法 **加粗内容** 或 __加粗内容__ ,即用两个星号或两个下划线将强调内容包起来。建议用两个星号(**),不建议用两个下划线(__)
2) 斜体
一个或一个_。
如果想 加粗且斜体,用三个*号包起来(
号前面要有一个空格)。
This is really very important text.

5.引用

如果要引用,在段落前加一个>符号。

这句话我没说! --鲁迅

要结束引用,需要另起一段(加一个空行)。
可以包含多个段落。在段落的空白行添加一个>符号。

这句话我没说! --鲁迅
我说过。 --罗翔

引用可以嵌套。在要嵌套的段落 前添加一个>>符号。

罗翔老师说过:

啤酒饮料矿泉水,瓜子香烟大碗茶。 --罗翔

块元素可以包含一部分其他markdown格式的元素,如**,###等。

6.列表

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

注意:
1. 数字或-后要有一个空格,不然不识别
2. 创建子列表用四个空格  
2. 列表最好另起一段(即用空行隔开)
  1. 标题
    1. 子列表1
    2. 子列表2
  2. 段落

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

  • 列表1
  • 列表2
    • 子列表1
    • 子列表2
  • 列表3
  • 列表4

在列表中嵌套其他元素:

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

  2. 嵌套引用块

    罗翔老师说过

  3. 嵌套代码块
    代码块通常用四个空格或一个制表符缩进。当它们被放在列表中时,请将它们缩进8个空格或2个制表符。

     <html>
         <head>
             <title>Test</title>
         </head>
     </html>
    
  4. 嵌套图片

  5. 嵌套列表

    • abc
    • cde

7.代码

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

注意:如果包裹的内容开始时有一个空格,对称的结束时也要有一个空格。
Markdown语法 HTML 预览效果
At the command promtp,type `nano` . At the command promtp,type<code>nano</code>. At the command promtp,type nano.

转义反引号
如果代码的单词或短语中包含一个或多个反引号,则可以通过将单词或短语包裹在反双引号( ``)中。

Markdown语法 HTML 预览效果
``Use `code` in your Markdown file.`` <code> Use `code` in your Markdown file.</code> Use `code ` in your Markdown file.

代码块
要创建代码块,2种方法:

  1. 将代码块的每一行缩进至少四个空格一个制表符

     <html>
         <head>
             <title>test</tile>
         </head>
     </html>
    
  2. 如果不用缩进的代码块,请使用围栏式代码块
    围栏代码块是用三个反引号(```)或三个波浪符号(~~~)。
    围栏代码块可以指定代码的类型(在第一个```后+空格+代码类型),如下代码类型指定为html:

     <html>
         <head>
             <title>test</tile>
         </head>
     </html>
    

8.分隔线

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

***  
---  
——————  
最佳实践:
为了兼容性,请在分隔线的前后均添加空白行。

----

9.链接

示例如下:

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

效果:
这是一个链接 Markdown语法
其中,

  1. 方括号中是链接描述,圆括号中是链接url和链接title。
  2. 最好的markdown教程是可选的title,用于显示鼠标悬浮在链接上浮动框中的文字。
  3. 可以给链接加格式,如加粗、斜体、可以把方括号中的链接描述设置为显示为代码等。

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

<https://markdown.com.cn>  
<[email protected]>  

效果如下:
https://markdown.com.cn
[email protected]

引用类型链接(锚点)
引用样式链接是一种特殊的链接,它使URL在Markdown中更易于显示和阅读。

例一

语法:[描述](#id)  

例子:  
<h3 id=_link_click_group>触发点 </h3>

[点击跳到链接一](#_link_1st)、[点击跳到链接二](#_link_2nd)、[点击跳到链接三](#_link_3rd)、脚注[^1]

<a id=_link_1st>链接一</a>([回到触发点](#_link_click_group))
<a id=_link_2nd>链接二</a>([回到触发点](#_link_click_group))
<span id=_link_3rd>链接三</span>([回到触发点](#_link_click_group))

[1]: 我是注脚

效果:

点击跳到链接一点击跳到链接二点击跳到链接三
生成一个脚注1[1]
链接一回到触发点
链接二回到触发点
链接三(回到触发点

例二
作为变量。变量的值不会显示在页面上。

这个链接用 3 作为网址变量 [Google][3]
这个链接用 runoob 作为网址变量 [Runoob][runoob]
然后在文档的结尾为变量赋值(网址)

  [3]: http://www.google.com/
  [runoob]: http://www.runoob.com/

效果:
这个链接用 3 作为网址变量 Baidu
这个链接用 runoob 作为网址变量 Runoob
然后在文档的结尾为变量赋值(网址)

10.链接

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

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

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

11.转义字符

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

\* Without the backslash, this would be a bullet in an unordered list.

渲染效果如下:
* Without the backslash, this would be a bullet in an unordered list.

12.内嵌HTML标签

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

HTML 用法最佳实践:  

出于安全原因,并非所有 Markdown 应用程序都支持在 Markdown 文档中添加 HTML。如有疑问,请查看相应 Markdown 应用程序的手册。某些应用程序只支持 HTML 标签的子集。

对于 HTML 的块级元素 <div>、<table>、<pre> 和 <p>,请在其前后使用空行(blank lines)与其它内容进行分隔。尽量不要使用制表符(tabs)或空格(spaces)对 HTML 标签做缩进,否则将影响格式。

在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

  1. 这是脚注的内容 ↩︎

标签:空格,markdown,HTML,代码,基础,列表,语法,Markdown,链接
From: https://www.cnblogs.com/enjoyable/p/16801629.html

相关文章

  • Pipline语法
    Pipline语法官网https://www.jenkins.io/zh/doc/book/pipeline/syntax/声明式流水线声明式流水线是最近添加到Jenkins流水线的[1],它在流水线子系统之上提供了一种更......
  • Python基础 字符串方法
    1、字符串首字母大写i="shulei_xiaoxin"S=i.capitalize()print(S)Shulei_xiaoxin2、字符串全部大写或小写i="shuLEI_XIAOxin"S=i.upper()S1=i.lower()......
  • linux基础
    今日内容概要运维简介服务器的种类和品牌服务器重要组成操作系统发展史虚拟化(windows)安装操作系统今日内容详细运维简介运维核心:运行维护应用程序MySQL运......
  • 盘点一个flask开发基础问题
    大家好,我是皮皮。一、前言前几天在Python钻石交流群【emerson】问了一个Flask基础的问题,提问截图如下:代码如下:@app.route('/zyh',methods=["GET","POST"])defzyh(......
  • JVM面试基础
    JVM包含JVM面试入门必知.一.概述1.JDK,JRE,JVM关系JDK:JavaDevelopmentKits,Java开发工具包,包括JRE和Java开发辅助工具;JRE:JavaRuntimeEnvironment,J......
  • Markdown 基本语法使用
    什么是Markdown?    Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯(JohnGruber)。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的 XHTML(或者......
  • RE语法
    RE,英文为RegularExpression,中文译作正则表达式。用于文本过滤的工具。RE语法由一些元字符、其它任意字符串作为基本单元,匹配次数、分组匹配、锚定符等为操作单元组成。进......
  • 正则表达式基础
    正则表达式定义定义了用来过滤数据流中的文本的模式模板正则表达式引擎作用一套底层软件,负责解析正则表达式模式并使用这些模式来进行文本匹配分类基础正......
  • Linux基础_7_文本显示
    注:实质是针对标准输出文本的各种骚操作!简单查看注:初略加工后进行显示。cat-n文件名#查看文件内容并显示行号tac文件名#逆序查看more文件名less......
  • Shell图形化脚本基础
    脚本菜单创建菜单创建菜单函数functionmemu{clearechoecho-e"\t\tTHEFUNCTION\n"echo-e"\t1.FUNCTION1"......