README.md文件

article/2025/9/23 14:50:33

引言:
README.md文件用的是Markdown编写的,所有我们先来看看Markdown的语法

首先在github上面某个项目里面创建一个README.md,然后在里面区编辑内容,如图,
在这里插入图片描述
点击edit file在下面输入内容,然后切换到preview changes进行预览,好了废话不说了,下面进入基本语法的练习

一、标题

	语法:#  文字内容

备注:一个#代表一级标题,2个#代表二级标题,依次类推支持6级标题,切记#和文字之间有个空格

#代码# 一级标题
## 二级标题
### 三级标题

二、字体

1、加粗

#内容左右各两个***我是加粗字体**

2、斜体

 #内容左右各一个**我是斜体*

3、斜体和加粗

#内容左右3个*
***我是加粗的斜体内容***

4、删除线

#内容左右个两个~
~~我是删除线~~

三、引用

在引用的文字前面加> ,可以嵌套一直增加下去 >>>>>…

>>我是引用
>>>>我是引用
>>>>>>>>>我是引用
>>>>>>>>>>>>>我是引用

展示效果
在这里插入图片描述

四、分割线

三个或者三个以上的 -或者*

---
*****

在这里插入图片描述

五、图片

![图片alt](图片地址 ''图片title'')解析:
图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加案例:
![这是熊猫](https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1571068885177&di=d85c9c7f61519d318ef353d8c3f98de9&imgtype=0&src=http%3A%2F%2Fp1.ssl.qhmsg.com%2Ft017cd895d6123f24ab.jpg "熊猫")备注:切记地址和title中间要有空格哦

六、超衔接

[超链接名](超链接地址 "超链接title")
title可加可不加案例:
[这是一个链接](http://www.baidu.com "百度首页")

效果
在这里插入图片描述

七、列表

1、无序列表

 + - * 任何一个都可以- 我是无序列表+ 我是无序列表* 我是无序列表备注:符号和文字之间有空格

效果
在这里插入图片描述
2、有序列表

1.我是有序列表
2.我是有序列表
3.我是有序列表
4.我是有序列表注意符号和内容之间有空格

3、列表嵌套
下一级向后缩进三个空格

4种组合情况 ,就不一一列举了

1. 一级有序列表1. 二级有序列表2. 二级有序列表3. 二级有序列表1. 一级有序列表* 二级无序列表* 二级无序列表* 二级无序列表1. 一级有序列表* 二级无序列表* 二级无序列表* 二级无序列表

效果如下:

在这里插入图片描述

八、表格

语法:表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容第二行分割表头和内容。
- 有一个就行,为了对齐,多加了几个
文字默认居左
-两边加冒号(:) 表示文字居中
-右边加冒号(:) 表示文字居右注:原生的语法两边都要用 | 包起来。此处省略示例:#居左
姓名|年龄|地址|籍贯
:-|:-|:-|:-
刘备|99|三国|山西
诸葛亮|99|三国|陕西
曹操|99|三国|陕西
周瑜|100|三国|陕西#居右
姓名|年龄|地址|籍贯
-:|-:|-:|-:
刘备|99|三国|山西
诸葛亮|99|三国|陕西
曹操|99|三国|陕西
周瑜|100|三国|陕西#居中
姓名|年龄|地址|籍贯
---|:--:|:--:|---:
刘备|99|三国|山西
诸葛亮|99|三国|陕西
曹操|99|三国|陕西
周瑜|100|三国|陕西

效国,依次:居左 居右 居中
在这里插入图片描述

九、代码

1、单行代码,代码用反引号“`”(数字键左边的键)括起来

`我是单行代码`

在这里插入图片描述

2、 代码块:代码之间分别用三个反引号包起来,且两边的反引号单独占一行

(```)
我是代码块
(```)

注:为了防止转译,前后三个反引号处加了小括号,实际是没有的。这里只是用来演示,实际中去掉两边小括号即可。

效果:
在这里插入图片描述
十、流程图
https://www.runoob.com/markdown/md-advance.html


http://chatgpt.dhexx.cn/article/2HZRLF2c.shtml

相关文章

GitHub上README.md教程

最近对它的README.md文件颇为感兴趣。便写下这贴,帮助更多的还不会编写README文件的同学们。 README文件后缀名为md。md是markdown的缩写,markdown是一种编辑博客的语言。用惯了可视化的博客编辑器(比如CSDN博客,囧)&a…

README文档的规范写法

看过很多开源库,发现有些库的文档写的一团糟,有的甚至就是一个标题,让你自己下载之后运行,自己摸索,看的很头疼。而那些使用量大的库的文档写的很标准,很详细,看的很舒服。 README文档写的好的…

你真的知道README吗?

目录 README MarkDown README的要素 API文档 总结 README是我们开发项目必备的文件,之前没有认真的研究过,都是大概的了解下,没想到里面也是一门大学问,话不多说,直接码起来。 README README是项目自我描述文件…

软件项目规范(1):README文件的基本写作规范

看Github的开源项目,我们都能看到README.md文件的身影。 有不少同学都喜欢将自己的项目上传到Git托管起来,但是总能发现一个问题:明明自己这个项目挺有市场的啊,怎么这个代码放上去,就显得很“非官方”! …

Java基础-快速入门

Java基础 Java基础-快速入门java简介java介绍java版本为什么学习javajava特点java优缺点优点缺点 java应用范围适用于不适用于 java规范java平台 安装JDK第一个Java程序安装并使用EclipseEclipse介绍Eclipse安装使用Eclipse创建第一个项目 安装Eclipse插件 Java基础-快速入门 …

Java-基础入门

1.发展历史 1995年Sun公司发布Java1.0版本 1997年发布Java1.1版本 1998年发布Java1.2版本 2000年发布Java1.3版本 2002年发布Java1.4版本 2004年发布Java1.5版本 2006年发布Java1.6版本 2009年Oracle甲骨文公司收购Sun公司,并于2011发布Java1.7版本 2014年…

java入门笔记

1. Java相关概念 编程:用倾向于自然语言的方式编写指令代码的过程 编译:将自然语言指令代码转化为机器语言(二进制)的过程系统差异化:为了用不同类型的芯片实现相同的功能,就需要用不同的指令代码操作不同…

一、Java基础入门

一、java简介 1.1 前言 Java语言是美国Sun公司(stanford University Network),在1995年推出的高级编程语言。所谓编程语言是计算机的语言,人们可以使用编程语言对计算机下达命令,让计算机完成人们需要的功能。 1996年1月,Sun公司发布了Java的…

Java基础及入门

一、软件开发基础 1.什么是JavaEE JavaEE是一门接收来自客户端的请求,并通过响应返回给客户端数据的技术。 2.JavaEE理解图 2.常用的开发语言 二、Java开发环境搭建 1.什么是JDK及JRE 安装JRE的目的是什么?(是为了编译代码) JDK&…

java入门的基础(入门必读)

Java入门基础 什么是java程序开发Java的运行环境开发Java程序的步骤java的基本框架数据类型、变量数据类型变量变量名命名规则 运算符关系运算符逻辑运算符算术运算符 扫描仪的使用if选择结构多重if选择结构嵌套if选择结构 switch选择结构循环结构while循环结构do-while循环结构…

JAVA基础学习入门

JAVA入门之基本语法(一) 最近开始复习JAVA语言为找工作做准备,方便以后再次复习或者用到的时候回顾。先是从JAVA的基本语法学起,因为有c和c语言的基础知识铺垫,所以这部分的笔记会比较粗略,毕竟语言都是贯…

Java基础入门(六)

Java基础入门(六) 1 Debug调试1.1 Debug概述1.2 Debug操作流程1.2.1 设置断点1.2.2 运行加了断点的程序1.2.3 Debugger窗口和Console窗口1.2.4 分步执行1.2.5 取消断点1.2.6 结束Debug1.2.7 注意事项 2.基础中常用的类2.1 Random随机数2.2 Scanner获取用…

Java基础之入门(一)

文章目录 Java帝国的诞生1. Java初生2. Java的发展3. Java特性和优势4. JVM、JRE、JDK5. Java程序的运行机制6.注释7. 标识符和关键字7.1 关键字7.2 标识符 8. 数据类型8.1 基本数据类型8.1.1 字符案例8.1.2 整型案例8.1.3 浮点型案例 8.2 引用数据类型 9. 类型转换9.1 转换方式…

java入门基础

语法基础 变量和常量 字符串 tring 类型是引用类型 字符串拼接可以直接用加号连接 自动类型转换 向上类型转换,是小类型到大类型的转换。 和C语音一样 int类型可以自动转换为double 但是double需要强制转换才能转换为int 强制类型转换 向下类型转换&…

JAVA基础入门学习

书籍推荐和视频推荐 Java核心卷I java核心卷II可以买也可以不买。java核心卷I只看前9章,其他不用看。身边同学都认为这本书不适合初学者,但是如果你之前看过java学习视频,那么这本书很适合你。这本书主要让你对java知识有个系统的学习&…

JAVA入门及基础

随着技术的不断发展,编程语言的种类也在越来越多,由全国知名TIOBE编程语言社区发布的编程语言排行榜来看,我们的JAVA在近两年来仍然占据榜二榜三,那么能一直稳居前排必然是有他的原因的:我们的JAVA具有使用广泛&#x…

《Java基础入门》第三版--黑马程序员课后习题(编程部分)

第 1 章 Java 开发入门 第 2 章 Java 编程基础 1. 编写程序,计算13…99的值,要求如下: (1)使用循环语句实现1~99的遍历 (2)在遍历过程中,通过条件判断当前的数是否为奇数,如果是就累加,否则不加。 public class getSum { 2 public static void main(String[] ar…

《Java基础入门》笔记——01 Java初步

1 关于Java 1.1 Java的发展简史 Java之父——Gosling(高司令)98年,Java2企业平台J2EE发布99年发布J2SE(标准版)、J2EE(企业版)、J2ME(微型版)04年,发布JavaSE5.009年,Oracle收购Sun14年,发布JavaSE8 1.2 Java语言的特点 简单。…

java基础入门(完整详细版)

前言: 这篇教程对没学过java的完全适用这篇教程是一个学习方向的引导,且只针对基础入门。 一.入门篇 1.安装JDK的运行环境 1.1 下载JDK 直接官网下载:http://www.oracle.com/;链接:网盘安装JDK点击就可以下载(推荐…

Linux udev规则编写

编写本文的目的: 看完本章,朋友们可以进行随心所欲的运用udev,编写udev规则,更好的管理Linux设备。例如,把硬盘sda根据盘的SN码生成一个软连接,使得SN码当做sda一样使用。 在文章结束后,既可以有方案可以实现。 udev是什么? udev 是 Linux2.6 内核里的一个功能,它替代…