当前位置: 首页 > news >正文

MarkDown的基本使用方法

为了给官方的文档知识总结:Markdown 基本语法 | Markdown 官方教程

#+空格+内容:‘#’表示标题的等级,越少表示标题级别越高(字越大)

在一行的末尾加两个或多个空格再回车,就是我们普通的文本回车。【还有一种兼容性可以使用HTML的<br>,然后也是回车的功效】

加粗文本:在要加粗的短语过后就两边加上**xx**(或者_xx_这样,但是Markdown 应用程序不太支持,所以还是用两边加*)

斜体:两边各加一个* 【类比加粗】

##关于引用

引用段落:在段落前面加一个>         引用多个段落模块:在段落之间的空白行加 >

块的嵌套:

其他元素的块引用:> -

##关于表

创建有序列表:在每一项前面添加数字并紧跟一个英文句点(第一项必须是1,其他会自己排序)

创建无序列表:在每一项前面添加破折号 (-)、星号 (*) 或加号 (+) 

                

 在列表中嵌套其他元素:将该元素缩进四个空格或一个制表符

代码块:

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

 

 ##关于代码语法

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

当代码里面的单词有' ' 的时候,用“ ” 把该代码引起来

 

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

要创建分隔线,请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___) ,并且不能包含其他内容。【为了兼容性,请在分隔线的前后均添加空白行。】 

 ##关于连链接

基本的:链接文本放在中括号内,链接地址放在后面的括号中

给链接增加 Title:放在圆括号中链接地址后面,跟链接地址之间以空格分隔。

注:链接title是指,鼠标悬停在链接上时会出现的文字【这个title可选】 

 网页与Email:

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

 强调链接, 在链接语法前后增加星号 

 将链接表示为代码,请在方括号中添加反引号

文本内部的引用链接:使用两组中括号进行格式设置 

第一部分:

第一组方括号包围应显示为链接的文本。第二组括号显示了一个标签,该标签用于指向存储在文档其他位置的链接。【第一组和第二组括号之间包含一个空格】,第二组括号中的标签不区分大小写,可以包含字母,数字,空格或标点符号。

 第二部分:

  1. 放在括号中的标签,其后紧跟一个冒号和至少一个空格(例如[label]: )。
  2. 链接的URL,可以选择将其括在尖括号中。
  3. 链接的可选标题,可以将其括在双引号,单引号或括号中。

 

注:不同的 Markdown 应用程序处理URL中间的空格方式不一样。为了兼容性,请尽量使用%20代替空格。

 ##添加图像

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

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

##转移字符语法

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

关于< 和 & 。:

HTML 文件中,有两个字符需要特殊处理: < 和 & 。 

  < 和 & 。 < 符号用于起始标签,& 符号则用于标记 HTML 实体,如果你只是想要使用这些符号,你必须要使用实体的形式,像是 &lt; 和 &amp;

翻译过来:  < 和 & 有自己特别的功能,如果你只是想打印出他们的样子,就必须写成 &amp;或者&lt;的形式

 Markdown 允许你直接使用这些符号,它帮你自动转义字符。如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &amp;

但是:Markdown会帮你自动转义字符,如果你使用 & 符号的作为 HTML 实体的一部分,那么它不会被转换,而在其它情况下,它则会被转换成 &amp;

所以如果要在文件中插入一个著作权的符号,你可以这样写:

你要知道:在 Markdown 的块级元素和内联元素中, < 和 & 两个符号都会被自动转换成 HTML 实体,这项特性让你可以很容易地用 Markdown 写 HTML。(因为在 HTML 语法中,你要手动把所有的 < 和 & 都转换为 HTML 实体。) 

HTML 的行级內联标签,可以在 Markdown 的段落、列表或是标题里任意使用。依照个人习惯,甚至可以不用 Markdown 格式,而采用 HTML 标签来格式化。

注:在內联标签的范围内, Markdown 的语法是可以解析的。但是Markdown 语法在 HTML 区块标签中将不会被进行处理。例如,你无法在 HTML 区块内使用 Markdown 形式的*强调*。【在 HTML 块级标签内不能使用 Markdown 语法。例如 <p>italic and **bold**</p> 将不起作用。

##关于区块标签

区块元素──比如 <div><table><pre><p> 等标签,必须在前后加上空行,以便于内容区分。而且这些元素的开始与结尾标签,不可以用 tab 或是空白来缩进。Markdown 会自动识别这区块元素,避免在区块标签前后加上没有必要的 <p> 标签。 

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

http://www.lryc.cn/news/90606.html

相关文章:

  • IDEA 安装配置步骤详解
  • 【网络】· 路由器中配置单臂路由和DHCP,VTP原理
  • Python 子域名扫描工具:使用多线程优化
  • 宝塔面板一键部署Z-Blog博客 - 内网穿透实现公网访问
  • 深入理解设计原则之单一职责原则(SRP)
  • 钉钉群通过短信转发器接收手机短信消息
  • 【C++模版】模版进阶 {非类型模版参数; 模版的特化; 模版的分离编译; 模版总结}
  • Azure Active Directory 的功能和优势
  • mysql查询语句执行过程及运行原理命令
  • 可视化探索开源项目的 contributor 关系
  • SpringBoot 实现启动项目后立即执行方法的几种方式
  • 2021第十二届蓝桥杯Python组国赛【真题+解析+代码】
  • 3D引擎渲染管理系统概览
  • 蔚来Java实习面经
  • nginx 搭建http-flv(rtmp)流媒体的一次尝试
  • Unity 工具 之 Azure 微软语音合成普通方式和流式获取音频数据的简单整理
  • 【A卡,Windows】stable diffusion webui下载安装避坑指南
  • 并发编程-系统学习篇
  • 在浏览器网页上使用JavaScript如何将mp4视频转换成gif动态图片
  • Nginx网络服务——主配置文件-nginx.conf
  • Java Map集合
  • 数据库中的中英文术语大全
  • 调用华为API实现身份证识别
  • 一个简单的基于C/S模型的TCP通信实例
  • VMware ESXi 8.0b Unlocker OEM BIOS 集成 REALTEK 网卡驱动和 NVMe 驱动 (集成驱动版)
  • ShardingSphere笔记(三):自定义分片算法 — 按月分表·真·自动建表
  • SpringBoot 如何实现文件上传和下载
  • Linux系统下imx6ull QT编程—— Ubuntu 下编写程序(一)
  • 网络编程--多线程服务器客户端
  • 如何使用vue的计算属性来处理数据计算?