Markdown语法-从基础到进阶

news2024/9/22 5:37:31

时代在进步,越来越多的人和软件开始使用Markdown进行文字编辑,其编辑方便性让很多人爱不释手。但是,不可避免的问题是,在编辑的时候,经常会需要去google,毕竟,习惯了office的可视化操作符号,很多时候,我们只关注操作,而不清楚原理,就会导致,我们会忘记一些不常用的操作。

为了不再一直去google,这里整理了一些markdown的语法。只看这一篇,就能解决80%的markdown问题。

接下来,展示一下基础语法,可以完成大部分的编辑需求。
大家可以使用StackEdit中文版,来在线熟悉Markdown(https://stackedit.cn/app#)语法。
也可以参考Markdown的官网进行学习:https://markdown.com.cn/basic-syntax/

1 基础版

image.png

1.1 标题

标题可以通过两种方法来展示,类 Atx 形式和类 Setext 形式。
我们一般使用类 Atx 形式。
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

语法:

#Space一级标题文字
##Space二级标题文字
###Space三级标题文字
####Space四级标题文字
#####Space五级标题文字
######Space六级标题文字

展示:
image.png

1.2 字体

常见的字体格式有粗体、斜体、删除线、高亮、行内代码
这些字体格式是可以随意组合的。

Markdown 使用星号()和底线(_)作为标记强调字词的符号,两个符号都可以实现字体格式。
唯一的限制是,用什么符号开启标签,就要用什么符号结束
一般推荐使用
,因为不用切换输入法。

注意⚠️
1.如果 * 和 _ 两边都有空白的话,它们就只会被当成普通的符号。
2.如果要在文字前后直接插入普通的星号或底线,你可以用反斜线 \

1.2.1 粗体

语法:

**粗体**Space
__这也是粗体__Space

展示:
image.png

1.2.2 斜体

语法:

*斜体*Space
_这也是斜体_Space

展示:
image.png

1.2.3 删除线

语法:

~~删除线~~Space

展示:
image.png

1.2.4 高亮

语法:

==高亮==Space

展示:
image.png

1.2.5 行内代码

语法:

`行内代码`Space

展示:
image.png

以上是一些特殊字体的语法,当然根据实际需要也可以做出一些组合,比如:
image.png

1.3 分割线

可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:

语法:

----
****
____
- - -

展示:
image.png

1.4 列表

列表分为无序列表、有序列表、任务列表。

1.4.1 无序列表

无序列表使用星号、加号或是减号作为列表标记。一般建议使用减号,因为星号会触发标题属性,加号在某些app上会触发特殊作用。

列表可以嵌套,上一级和下一级之间敲三个空格,然后回车在一行即可。

语法:

-Space无序列表1
-Space无序列表2
Space``Space``Space
-Space无序列表2-1
-Space无序列表2-2
Space``Space``Space``Space``Space``Space
-Space无序列表2-2-1

展示:
image.png

1.4.2 有序列表

有序列表使用数字+英文句点+空格
语法:

1.Space有序列表1
2.Space有序列表2
3.Space

展示:
image.png

1.4.3 任务列表

任务列表一般用于设计任务整理。
已完成任务,可以在[]中间增加"x"。
注意 - 后、[ ] 内和 [ ] 后的空格
语法:

-Space[Space]Space任务1
-Space[x]Space任务2
-Space[Space]Space任务3

展示:
image.png

1.5 代码块

代码块可以支持代码格式,也可以默认不写。

语法:

```javaScriptEnter
代码内容
````Enter`

展示:
image.png

1.6 引用

在引用的文字前加 > 即可。 在 Markdown 文件中建立一个区块引用,markdown也支持多层引用,类似于标题的写法,不断增加> 即可。

语法:

>Space引用文字
>Space>Space第二层引用
>Space>Space>Space第三层引用

展示:
image.png

1.7 插入图片

展示:image.png

1.8 超链接

跳转到其他网站的超链接导航,使用[]写入文字,然后在后面()写入超链接地址。
加上链接的 title 文字,只要在网址后面加空格,然后用双引号把 title 文字包起来即可。
语法:

这会跳转到[乾复道](https://www.yuque.com/morange)的语雀花园;
这会跳转到[乾复道](https://www.yuque.com/morange “乾复道的语雀花园”)的语雀花园;

展示:
image.png

1.9 表格

语法:

| 表头 | 表头 | 表头 |
| :-- | :–: | ----: |
|内容 | 内容 | 内容 |

操作解读:

  • | 是英文格式,原生的语法两边都要用 | 包起来,建议遵从;
  • 第一行是表头;
  • 第二行分割表头和内容。 - 有一个就行,为了对齐,多加了几个;
    • 文字默认居左,也可以在 - 左边加英文冒号;
      • 两边加英文冒号,表示文字居中;
      • 右边加英文冒号,表示文字居右;

展示:
image.png

2 进阶版

基础版的语法已经足以应付大部分的情况,当然,有时候我们想让文档看起来更漂亮一些,就可以用一些排版的进阶语法。实际上,就是通过HTML的标签来实现。
这需要一些小小的HTML知识,所以就不在此讲解HTML了,直接上语法和展示,具体自行感悟吧!

2.1 字体

2.1.1 更改字体、大小、颜色

语法:

<font face=“黑体”>我是黑体字</font>
<font face=“微软雅黑”>我是微软雅黑</font>
<font face=“STCAIYUN”>我是华文彩云</font>
<font color=red>我是红色</font>
<font color=#008000>我是绿色</font>
<font color=Blue>我是蓝色</font>
<font size=5>我是尺寸</font>
<font face=“黑体” color=green size=5>我是黑体,绿色,尺寸为5</font>

展示:
image.png

2.1.2 增加文字背景色

语法:

<table><tr><td bgcolor=yellow>背景色yellow</td></tr></table>

展示:
image.png

2.1.3 文字居中、左对齐、右对齐

语法:

<center >居中</center>
<p align=“left”>左对齐</p>
<p align=“right”>右对齐</p>

展示:
image.png

2.1.4 文字上标、下标

语法:

上标^th^
下标~th~

展示:
image.png

2.2 超链接

点击超链接时,新打开一个标签页
语法:

<a href=“https://www.yuque.com/morange” target=“_blank”>乾复道的语雀花园</a>

展示:
image.png

使用参考式,将链接统一管理。
链接的参考式的定义可以放在文件中的任何一个地方,本人比较偏好直接放在文件最后面,就像是注解一样。

  • 链接内容的形式为: _方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字 _接着一个冒号 _接着一个以上的空格或制表符 _接着链接的网址 _选择性地接着 title 内容,可以用单引号、双引号或是括弧包着 _链接网址也可以用尖括号包起来

语法:

[乾复道的语雀花园][index]
[百度主页][baidu]

[index]:https://www.yuque.com/morange “title”
[baidu]:https:www.baidu.com

展示:
image.png

自动链接,即在文章中直接展示http地址,一般用于,展示网址或者邮件信箱。
语法:

<https://www.yuque.com/morange>

展示 :
image.png

2.3 目录

自动生成目录,很简单,在你想要生成目录的地方增加[TOC]就好了。

语法:

[TOC]

# 1标题
内容1

## 1-1标题
内容1-1

----

# 2标题

----

展示:
image.png

2.4 UML图、流程图、甘特图、饼状图

UML图、流程图、甘特图,其实有很多专业的可以执行,其实不建议使用markdown,毕竟,用markdown写这些图,会比较麻烦,且不利于修改。
也可以参考菜鸟教程(https://www.runoob.com/markdown/md-advance.html)的图解。

2.4.1 UML图

语法:

```mermaid
sequenceDiagram
爱丽丝 ->> 鲍勃: 你好鲍勃,你好吗?
鲍勃–>>约翰: 约翰,你呢?
鲍勃–x 爱丽丝: 我很好,谢谢!
鲍勃-x 约翰: 我很好,谢谢!
Note right of 约翰: 鲍勃想了很长
很长的时间,太长了
文本确实
不能放在一行中。

鲍勃–>爱丽丝: 正在和 John 核对…
爱丽丝->约翰: 是的……约翰,你好吗?
```

展示:
image.png

2.4.2 流程图

语法:

```mermaid
graph LR
A[长方形] – 链接文本 --> B((圆形))
A --> C(圆角矩形)
B --> D{菱形}
C --> D
```

展示:
image.png

2.4.3 甘特图

语法:

```mermaid
gantt
title 这是个甘特图的例子
dateFormat MM-DD

section 软件协同开发课程
项目启动 :done,des1,03-09,7d
项目计划 :done,des2,after des1,6d
需求分析 :done,des3,after des2,9d
软件设计 :done,des4,after des3,12d
软件编码 :crit,active,des5,04-07,20d
软件测试 :des6,04-14,15d
项目交付 :des7,after des6,4d
\ ```

展示:
image.png

2.4.3 饼状图

语法:

```mermaid
pie
title 城市生存训练能力占比
“独立自理” : 15
“情商” : 20
“人际交往” : 15
“地理常识” : 10
“财商” : 10
“安全防护” : 20
“感恩之心” : 10
```

展示:
image.png

3.结语

学习以上markdown语法,相信已经可以完成大部分的操作场景了。当然,如果大家有什么有的操作语法,也可以和我一起讨论,共同丰富文档。

积土成山,风雨兴焉;积水成渊,蛟龙生焉;积善成德,而神明自得,圣心备焉。故不积跬步,无以至千里;不积小流,无以成江海。骐骥一跃,不能十步;驽马十驾,功在不舍。锲而舍之,朽木不折;锲而不舍,金石可镂。蚓无爪牙之利,筋骨之强,上食埃土,下饮黄泉,用心一也。蟹六跪而二螯,非蛇鳝之穴无可寄托者,用心躁也。
——《劝学

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/188594.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

在成都Java培训班学习五个多月有用吗?

不知道“有用”的标准是什么&#xff0c;是能入行上岗工作&#xff0c;还是想只通过几个月的培训一跃成为资深开发攻城狮&#xff1f;这里不得不给大家泼瓢冷水&#xff0c;短期培训能让你对口上岗工作就很不错了&#xff1b;想要成为技术大佬&#xff1f;大学里面四年都没能让…

2023年南京Java培训机构排行榜上线,犹豫的小伙伴们看过来!

2022年&#xff0c;JRebel发布了《2022年Java发展趋势和分析》&#xff0c;它通过调研问卷的方式总结的报告&#xff0c;涉及了不同国家、不同岗位、不同公司规模、不同行业&#xff0c;相对来说&#xff0c;该调查报告是有一定参考意义的。数据显示&#xff0c;Java这一语言在…

使用Chisel搭建Systolic Array

最近听到非常多人吹Chisel&#xff0c;为了方便快速做算法实现&#xff0c;就去尝试学了下&#xff0c;发现确实很香&#xff0c;有种相见恨晚的感觉。今天是使用Chisel搭建个脉动阵列&#xff08;Systolic Array, SA&#xff09;[1]&#xff0c;脉动阵列是神经网络中最基础也是…

用递归玩转简单二叉树

前言&#xff1a; 数据结构学到二叉树&#xff0c;就进入到了有难度的部分了&#xff0c;但难度对应着重要性&#xff0c;其重要性也不言而喻了。这节我会介绍用C语言实现递归方法的二叉树的一些重要基本功能&#xff0c;在二叉树中又属于基础知识&#xff0c;有需要的各位必须…

下载CleanMyMac X有什么好处?最新版本有哪些新功能

CleanMyMac X 是一款先进的、集所有功能于一身的实用系统清理工具&#xff0c;它能帮助保持您的Mac保持清洁。只需两个简单的点击&#xff0c;就可以删除无用的文件&#xff0c;以节省您宝贵的磁盘空间。CleanMyMac X可以流畅地与系统性能相结合&#xff0c;清洁不需要的语言、…

EasyCVR新增角色分配分组功能的使用及注意事项

我们在此前的文章中分享过关于EasyCVR分组功能的更新&#xff0c;具体可以查看这篇文章&#xff1a;AI云边端EasyCVR平台新功能解析&#xff1a;支持为角色选择多级分组。今天我们来为大家介绍一下&#xff0c;新功能在配置时需要注意的事项。1、首先我们先简单回顾一下老版本的…

【Js】语法糖之数组解构和拆包表达式

文章目录数组结构拆包表达式来源数组结构 在ES5中&#xff1a;如果计划从数组中提取特定元素&#xff0c;就需使用元素的索引&#xff0c;并将其保存到变量之中。 在ES6中&#xff1a;新增数组解构功能&#xff0c;以简化获取数组中数据的过程。 数组解构采用了数组字面量的…

【SpringCloud复习巩固】Sentinel

sentinel 链接&#xff1a;https://pan.baidu.com/s/1lLJKBSDJNJgW5Lbru6NYrA 提取码&#xff1a;ut3g 目录 一.初识Sentinel 1.1雪崩问题及其解决方案 1.2认识Sentinel 1.3安装Sentinel控制台 1.4微服务整合sentinel 二.限流规则 2.1簇点链路 2.2流控规则 2.3流控效果…

从0~1实现 单体或微服务下 实现订单未支付超时取消功能 方案(2)-rocketmq 延迟队列方案 完整设计和源码

从0~1实现 单体或微服务下 订单未支付超时取消功能 方案&#xff08;1&#xff09;-java delayquene 注册中心(zookeeper/nacos)高可用方案从0~1实现 单体或微服务下 订单未支付超时取消功能 方案&#xff08;2&#xff09;-rocketmq 延迟队列方案 场景说明 我们日常接触的电…

IronPDF for .NET 2023.1 Crack

关于 .NET 的 IronPDF 创建、编辑和导出 PDF 文档。 IronPDF for .NET 允许开发人员在 C#、F# 和 VB.Net for .NET Core 和 .NET Framework 中轻松创建 PDF 文档。您可以选择简单的 HTML&#xff0c;或合并 CSS、图像和 JavaScript。IronPDF 呈现紧跟谷歌浏览器。 IronPDF 功能…

eclipse新手快捷键

1. ctrlshiftr&#xff1a;打开资源 这组Eclipse快捷键可以让你打开你的工作区中任何一个文件&#xff0c;而你只需要按下文件名或mask名中的前几个字母&#xff0c;比如applic*.xml。美中不足的是这组快捷键并非在所有视图下都能用。 2. ctrlo&#xff1a;快速outline 列出…

2023年深圳Java培训机构排名,不看后悔系列!

不忘初心&#xff0c;方得始终。2023&#xff0c;继续战斗&#xff01;想要学习Java的小伙伴们看过来~深圳Java培训机构排名最新排行榜来了&#xff01;靠谱的Java培训机构都在这里&#xff0c;总有一个你喜欢的&#xff0c;总能选出一个合适你的&#xff0c;快拿出小本本记下这…

【MyBatis】搭建MyBatis

1、MyBatis简介 1.1、MyBatis历史 MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下&#xff0c; iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github。iBatis一词来源…

2023年flash水坑攻击源码

1. 背景 在有授权的攻防演练中&#xff0c;很多时候都会用到水坑攻击或者钓鱼&#xff0c;目前flash钓鱼一直都在做&#xff0c;以前的版本中&#xff0c;提示flash版本过低是这样的&#xff1a; 下载界面是这样的&#xff08;下图来源于互联网&#xff09;&#xff1a; 但是目…

javascript封装一个单向链表

单向链表 单向链表类似于火车&#xff0c;有一个火车头&#xff0c;火车头会连接一个节点&#xff0c;节点上有乘客&#xff0c;并且这个节点会连接下一个节点&#xff0c;以此类推。 链表的火车结构 链表的数据结构 head 属性指向链表的第一个节点。 链表中的最后一个节点指…

2023年郑州Java培训机构排名新鲜出炉,快来看看都有哪些!

郑州是一个很有发展潜力又极具竞争力的城市&#xff0c;很多大厂现在都在往二线城市转移&#xff0c;其中郑州就是一个很好的选择。所以想要在郑州有好的发展前景&#xff0c;就要不断提高自己的技术竞争力&#xff0c;Java软件开发就成为了不少小伙伴们想要提升价值技能选择的…

Pytorch 基础

✅作者简介&#xff1a;人工智能专业本科在读&#xff0c;喜欢计算机与编程&#xff0c;写博客记录自己的学习历程。 &#x1f34e;个人主页&#xff1a;小嗷犬的个人主页 &#x1f34a;个人网站&#xff1a;小嗷犬的技术小站 &#x1f96d;个人信条&#xff1a;为天地立心&…

【职工管理系统】C++全栈体系(十五)

职工管理系统 第十一章 添加职工 功能描述&#xff1a;按照职工的编号进行删除职工操作 一、删除职工函数声明 在workerManager.h中添加成员函数 void Del_Emp(); //删除职工void Del_Emp();二、职工是否存在函数声明 很多功能都需要用到根据职工是否存在来进行操作如&…

基于Android的综合物流系统

需求信息&#xff1a; &#xff08;1&#xff09;后台管理平台 设计实现物流管理平台&#xff0c;完成对司机、所载货物、出发点、目的地、运输轨迹等的管理。主要研究的内容为前后端框架的选择&#xff0c;对系统信息的展示与管理。 数据展示&#xff1a;管理人员通过不同的筛…

Redis持久化 | 黑马Redis高级篇

目录 RDB持久化 1、介绍 2、命令 3、配置 4、bgsave的fork底层原理 5、总结 AOF持久化 1、介绍 2、开启 3、三种写回策略 4、AOF后台重写 混合持久化 总结 Redisd的持久化有两种方式&#xff0c;分别是RDB和AOF RDB持久化 1、介绍 RDB&#xff0c;Redis数据备份…