darkdown语法详解(readme语法)

news2025/2/26 5:56:23

1.简介

Markdown就是一种文档的格式,文件名的末尾是.md,是一种轻量级的标记语言,目前已经在Github、csdn等多个网站使用。

1.1.优点

  • 排版语法简单
  • 可在任何支持markdown语法的地方无缝迁移,避免了
    我们常见的迁移后需要重新排版等问题

1.2.在线试用

markdown官方的在线编辑器:官方在线编辑器

2.Markdown语法教程

2.1.基本语法

基本语法包括:标题文本链接引用代码

2.1.1.标题

1-6个“#”加空格,“#”数量越多,字体越小

一号标题

二号标题

三号标题

四号标题
五号标题
六号标题

2.1.2.分割线

在单独一行上使用三个或多个星号 (***)、破折号 (—) 或下划线 (___) ,并且不能包含其他内容。
例如:




2.1.3.文本

        直接输入的文字就是普通文本。需要注意的是换行的时候不能直接通过回车来换行,需要使用 <br>(或<br/>

空格: 输入“&#160;”/"&nbsp;"来输入空格或者输入法由半角改为全角可以输入空格

换行: 使用 <br>(或<br/>或者两个空格加回车即可

2.1.4.字体

样式语法快捷键示例
粗体** ** 或 __ __Command+B (Mac) 或 Ctrl+B (Windows/Linux)这是粗体文本
斜体* * 或 _ _Command+I (Mac) 或 Ctrl+I (Windows/Linux)这是斜体文本
删除线~~ ~~这是错误文本
粗体和嵌入的斜体** ** 和 _ _这是 嵌入斜体 粗体
粗体且斜体*** ***粗体且斜体
下标 这是下标文本
上标 这是上标文本

2.1.5.字体、字号和颜色

需要用到HTML语法,有些网站不支持此语法;像CSDN,它的Markdown编辑器做了很好的扩展、支持HTML语法,就有这样的功能。
语法:
< font face='楷体' color=#ff00ff size=5>楷体粉红5号</font>
例如:

楷体粉红5号

含义:

样式含义示例
face字体可以改成“宋体”、“楷体”、“微软雅黑”等等
size字体大小一般是从1-7,浏览器默认为3
color文字颜色十六进制或rgb来表示,(基本颜色大全)

2.1.6.背景色

markdown语法里,本身也是没有背景色这样一个选项,需要用内置HTML的形式,借助 table, tr, td 等表格标签的 bgcolor 属性来实现背景色的功能。
语法:
<table><tr><td style="background-color: blueviolet>背景色是紫色</td></tr></table>

例如:

背景色是紫色

2.1.7.链接

  • 基本链接

    语法: [文本替换链接](链接)
    例如: 本人博客主页
    HTML语法形式: <a href="超链接地址" title="超链接title">超链接显示名</a>
    例如: 超链接显示名称

  • 图片链接

    语法: [图片解释性内容](图片链接)
    例如: 在这里插入图片描述

    HTML语法形式: <img src="图片链接" alt="图片alt" title="图片title">
    例如: 图片alt

    一般情况下,你图片直接复制进去就可以,链接会自动生成。如果你的图片仅仅是保存在本地,没有存放到图床等地方,那么当你的文件传输给别人的时候,就会丢失。
    这个时候,需要把图片存放到云端。具体的方法就是要搭建图床。Github图床搭建方法

  • 页内链接(锚点

    语法: 跳转到[目录标题](#index)
    例如: 跳转到背景色

注意有些编辑器可能不支持。还有在简书里,它可能会重新跳出来一个页面然后去跳转。所以,这个功能还需要看具体的编辑器是否支持。

2.1.8.引用

  • 基本引用: 段落前面加上一个 “>”

    这是一个引用

  • 引用嵌套: 在引用里面再加一层引用

    这是第一层引用

    这是第二层引用

    这是第三层引用

2.1.9.代码

  • 插入程序代码: 使用“``"(反引号)表示单行代码引用,如:这是单行

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

    printf("hello world");

    printf(“hello world”); //这是HTML语法

  • 代码块: 在代码的上一行和下一行用 “```”三个反引号 标记,注意,需要和普通段落之间存在空行。

    public static void sort(List<String> v) {
        if (v == null || v.size() <= 0) return;
        Collections.sort(v);
    }
    

        开头三个反引号后面可跟具体的编程语言,会有不同的关键字提示符。

2.2.进阶语法

2.2.1.无序列表

使用 *,+,- 表示无序列表。例如:

  • 无序列表
  • 无序列表

如果要控制列表的层级,则需要在符号-前使用空格。例如:

  • 无序列表1
  • 无序列表2
    • 无序列表2.1
    • 无序列表2.2

2.2.2.有序列表

在数字加符号.加空格表示有序列表。例如:

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

如果要控制列表的层级,需要在列表行使用tab建。例如:

  1. 有序列表1
    1. 有序列表1.1
    2. 有序列表1.1.1
  2. 有序列表2
    1. 有序列表1.1
      1. 有序列表1.1.1

2.2.3.表格

语法:

第一列第二列第三列
数据一数据二数据三
使用冒号来定义表格的对齐方式

2.2.4.数学公式

支持平台:微信公众号、知乎等。

  • **行内公式:**使用两个” ”符号引用公式 , ”符号引用公式, 符号引用公式,公式$

指数: a 2 3 a^3_{2} a23         这个^后面,就是跟着一个指数,然后_的后面跟着的就是下标

向量 $\vec a$表示向量a

A B → \overrightarrow{AB} AB         表示向量AB,箭头指向右(即A->B)
A B ← \overleftarrow{AB} AB         表示向量BA,箭头指向左(即A<-B)

分数: x 2 k + 1 \frac{x^{2}}{k+1} k+1x2         $\frac{x^{2}}{k+1}$前面表示分子,后面表示分母
求和: ∑ i = 1 n \sum_{i=1}^{n} i=1n         按照$\sum_{...}^{...}$的格式
积分: ∫ 0 π \int_{0}^{\pi} 0π         按照$\int_{...}^{...}$的格式
求积: ∏ 0 n \prod_{0}^{n} 0n         按照$\prod_{...}^{...}$的格式

  • 块公式: $$公式$$

    矩阵:
    ( 1 a 1 a 1 2 ⋯ a 1 n 1 a 2 a 2 2 ⋯ a 2 n ⋮ ⋮ ⋮ ⋱ ⋮ 1 a m a m 2 ⋯ a m n ) \begin{pmatrix} 1 & a_1 & a_1^2 & \cdots & a_1^n \\ 1 & a_2 & a_2^2 & \cdots & a_2^n \\ \vdots & \vdots & \vdots & \ddots & \vdots \\ 1 & a_m & a_m^2 & \cdots & a_m^n \\ \end{pmatrix} 111a1a2ama12a22am2a1na2namn

2.2.5.流程图

tag=>type: content:>url

例如:

st=>start: 开始
e=>end: 结束
op=>operation: 过程1
sub1=>subroutine:程序1
cond=>condition:yes/no
io=>input/output: 输入/输出
st->op->cond
cond(yes)->io->e
cond(no)->sub1(left)->op

2.2.5.横屏滑动幻灯片

支持平台:微信公众号。

通过<![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=url&pos_id=img-l6d3nDur-1710826275096),![外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传](https://img-home.csdnimg.cn/images/20230724024159.png?origin_url=url&pos_id=img-659jeQPw-1710826275097)>这种语法设置横屏滑动滑动片,具体用法如下:

<蓝1,绿2,外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传>

2.3.特殊语法

2.3.1.目录

平常的 markdown 语法支持自动生成目录,使用 [toc] 或者 @[toc] ,markdown 编辑器就能根据 标题 形成目录,也就是说,目录是根据标题语法 # 索引的。

2.3.2.表情

arkdown 语法支持添加 emoji 表情,比如输入 :blush: 会显示😊。

emoji 语法在这个网站 https://www.webfx.com/tools/emoji-cheat-sheet/

3.3.3.HTML

支持原生 HTML 语法,请写内联样式,如下:

橙色居右
橙色居中

###3.3.4.UML
不支持,推荐使用开源工具https://draw.io/制作后再导入图片

参考:
https://blog.csdn.net/xdnxl/article/details/129518943
https://markdown.com.cn/editor/
https://blog.csdn.net/weixin_38673554/article/details/106996323

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

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

相关文章

【动态规划】算法例题

目录 一维动态规划&#xff1a; 137. 爬楼梯 ① 138. 打家劫舍 ② 139. 单词拆分 ② 140. 零钱兑换 ② 141. 最长递增子序列 ② 多维动态规划&#xff1a; 142. 三角形最小路径和 ② 143. 最小路径和 ② 144. 不同路径 II ② 145. 最长回文子串 ② 146. 交错字符串…

讯鹏智能边缘计算网关主机,支持MQTT协议主动上传上位机软件平台

随着科技的不断发展&#xff0c;智能化设备在我们的生活中扮演着越来越重要的角色。而智能边缘计算网关作为连接智能设备与互联网的重要纽带&#xff0c;其远程运维功能为管理者带来了极大的便利。特别是像OkEdge边缘计算网关这样的产品&#xff0c;不仅可以替代传统的Windows系…

Vmware虚拟机配置虚拟网卡

背景 今天同事咨询了我一个关于虚拟机的问题&#xff0c;关于内网用Vmware安装的虚拟机&#xff0c;无法通过本机访问虚拟上的Jenkins的服务。   验证多次后发现有如下几方面问题。 Jenkins程序包和JDK版本不兼容&#xff08;JDK1.8对应Jenkins不要超过2.357&#xff09;虚拟…

【Cesium】波纹圆效果

效果图&#xff1a; 代码&#xff1a; 需要扩展源码&#xff1a;circleRippleMaterialProperty.js /** Description: 波纹圆效果&#xff08;和水波纹扩散类似&#xff0c;参考开源代码&#xff09;* Version: 1.0*/ class CircleRippleMaterialProperty {constructor(option…

C语言例3-27:使用条件运算符的例子

条件运算符的优先级&#xff1a; 其他运算符 优先于 条件运算符 优先于 赋值和复合赋值运算符 优先于 逗号运算符条件运算符的结合性是从右至左 条件运算符的一般使用形式&#xff1a; 表达式1&#xff1f;表达式2&#xff1a;表达式3 条件表达式的执行过程是先表达式1&…

C++ Qt开发:QUdpSocket网络通信组件

Qt 是一个跨平台C图形界面开发库&#xff0c;利用Qt可以快速开发跨平台窗体应用程序&#xff0c;在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置&#xff0c;实现图形化开发极大的方便了开发效率&#xff0c;本章将重点介绍如何运用QUdpSocket组件实现基于UDP的网络通信…

Spring Bean的生命周期是怎么样的?

一、问题解析 一个Spring的Bean从出生到销毁的全过程就是他的整个生命周期&#xff0c;那么经历以下几个阶段&#xff1a; ​ 整个生命周期可以大致分为3个大的阶段&#xff0c;分别是&#xff1a;创建、使用、销毁。还可以进一步分为5个小的阶段&#xff1a;实例化、初始化、…

计算机生物科技在基因编辑中的应用及其前景

一、引言 基因编辑&#xff0c;作为一种能够精准修改生物体基因组的技术&#xff0c;近年来受到了广泛的关注。 而计算机生物科技作为连接计算机科学与生物学的桥梁&#xff0c;为基因编辑技术的快速发展提供了强大的支持。通过利用计算机算法和数据分析方法&#xff0c;研究人…

Java基础学习笔记三

环境变量CLASSPATH classpath环境变量是隶属于java语言的&#xff0c;不是windows操作系统的&#xff0c;和PATH环境变量完全不同classpath环境变量是给classloader&#xff08;类加载器&#xff09;指路的java A 。执行后&#xff0c;先启动JVM&#xff0c; JVM启动classload…

反射 Reflection

反射 反射的概念 反射机制允许程序在执行期借助于ReflectionAPI取得任何类的内部信息(比如成员变量&#xff0c;构造器&#xff0c;成员方法等等)&#xff0c;并能操作对象的属性及方法。反射在设计模式和框架底层都会用到加载完类之后&#xff0c;在堆中就产生了一个Class类型…

集合Python开发环境搭建

目录 PyCharm搭建Python环境_非虚拟环境 Pycharm的优点 Pycharm的缺点 Pycharm的下载 Pycharm环境配置 VSCode搭建Python环境_非虚拟环境 VSCode的优点 VSCode的缺点 VSCode的下载 VSCode环境配置 虚拟环境使用 虚拟环境介绍 虚拟环境安装 创建虚拟环境 切换虚拟…

使用 Vue CLI 创建一个 Vue2 项目

全局安装 Vue CLI 参考官网 Vue CLI&#xff0c;安装命令如下 npm install -g vue/cli 目前 Vue CLI 的最新版本为 v5.0.8 创建 Vue2 项目 在希望创建项目的目录下打开命令行&#xff0c;键入命令 vue create my-project 其中 my-project 更改为自己需要的项目名 随后&a…

R语言程序设计(零基础速通R语言语法和常见函数的使用)

目录 1.Rstudio中的一些快捷键 2.R对象的属性 3.R语言中常用的运算符​编辑 4.R的数据结构 向量 如何建立向量&#xff1f; 如何从向量里面提取元素&#xff1f; 矩阵 如何建立矩阵&#xff1f; 如何从矩阵里面提取元素&#xff1f; 数据框 如何建立数据框&#xf…

行业逆行者倪张根的十数年

在2015年的一场发布会上,梦百合家居董事长倪张根接受完全国80多家媒体的群访后,突然起身深深鞠了一躬,把在场的记者们吓了一跳。 对此,倪张根直接、坦率地承认“就是想讨好在座的各位”,这种不够柔和、不够世故的直球表达方式,在这个向来讲究中庸的社会,有种让人避之不及却又惊…

idea maven 项目融合

背景 &#xff1a;项目A 和项目B 是两个独立的多模块项目&#xff0c;项目A 和项目B &#xff0c;均为独立的数据源 。其中项目B 有两个数据原。 需要将项目B 以多模块的方式融合进项目A。 解决版本。建立项目C&#xff0c;只含有pom的&#xff0c;空项目&#xff0c;项目A和项…

【经验分享】Wubuntu------体验Windows和Ubuntu的结合体

【经验分享】Wubuntu------体验Windows和Ubuntu的结合体 最近看到有一款Wubuntu的文章&#xff0c;对于习惯使用windows操作系统&#xff0c;又不熟悉ubuntu系统的程序员小白来说&#xff0c;可以说是福音了。目前的Wubuntu兼容性可能还有一点问题&#xff0c;如果再迭代几次的…

nodejs 使用express插件multer文件上传,接收不到文件的bug

把路径改成绝对路径即可 改成 temp是你想上传到文件夹的路径&#xff0c;一般是在项目根目录下

pinia的使用vue3

1.安装pinia pinia持久化工具pinia-plugin-persist npm install pinia pinia-plugin-persist -D -S2.使用pinia main.js import store from "//store"; app.use(store);index.js import { createPinia } from "pinia"; import piniaPluginPersist fro…

攻防世界新手模式例题(Web)

PHP2 首先我们查看页面&#xff0c;查看前端代码 发现均没有什么有效信息&#xff0c;由题目可知&#xff0c;此问题与php相关&#xff0c;于是我们可以看一下他的index.php文件 查看时用?index.phps 补充知识&#xff1a;phps文件就是php的源代码文件&#xff0c;通常用于…

【超图】白模数据如何与抽屉效果结合,展示白膜内部结构

作者&#xff1a;taco 最近在支持的过程中&#xff0c;客户在看别的项目中&#xff0c;发现白模是可以抽插的。而非单独一个白色模型建筑。那么如何使用SuperMap产品来实现抽插的效果呢&#xff1f;本篇文章结合SuperMap iDesktopX产品以及SuperMap iClient for Cesium产品进行…