帮助人们学习如何写自述文件
自述文件使用markdown(以下简称为“md”)语言编写。因此此项目主要简绍如何写md
#号是一个自述文件的基石,它可以创建将一段段正文隔开的标题。
#号后面需要加一个空格,才能起到标题的作用,否则只能是个普通字符串
示例
# 114514
1919810在md中,如果仅是按一下回车,那么上一行和下一行只会隔一段距离,并不会直接隔一行。因此,想要真正隔一行需要按两下回车
示例
ngm
hfv
kjj
kll效果
ngm hfv
kjj
kll
1.**号
这个字符串可以加粗字体,但本来用的字体就是粗体的话效果不是那么明显
示例
**666**效果
666
2.~~号
这个字符串可以施加删除线的效果
示例
~~777~~效果
777
3.```号
这个字符串可以显示代码。在第一个```后加上语言的名称可以对一些代码高亮。
示例
`` `kotlin
package hfhhfhzx.markdownguide
println("Hello World")
var tt = 3
`` `
(PS:第三个`号前我加了个空格,不然有麻烦)
效果
package hfhhfhzx.markdownguide
println("Hello World")
var tt = 34.-号
这个符号与#号的机制类似,效果是一个原点
示例
- 114
- 2145效果
- 114
- 2145
5.[]和()号
这两个号可以创建超链接。在小括号里输入URL可以跳转到这个URL,在小括号里输入./+文件名可以跳转到此github项目中自述文件所在目录的的文件,在小括号里输入# + 标题名可以跳转到自述文件中的标题
示例
[github](https://github.com)
[许可证](./LICENSE)
[114](#换行)效果
6.>号
这个符号可以在文字前面加一条竖线
示例
> 444
> [!CAUTION]
> 114
> [!NOTE]
> 555
> [!WARNING]
> 777
> [!TIP]
> 888
> [!IMPORTANT]
> 999效果
444
Caution
114
Note
555
Warning
777
Tip
888
Important
999
7.<!- -- ->号(PS:我加了两个空格,不然你们看不见)
这个号就是起到注释作用。实际没有太大作用
示例
<!--
这个意大利面就是要拌42混凝土
-->8._号
这个符号可以把文字变为斜体字
示例
_abcdefg_效果
abcdefg
9.`号
不多说,自己看
示例
`1919`效果
1919
10.$号
这个符号也可以把文字变为斜体字,但是字体较粗
示例
$yyswys$效果
徽标主要用于显示项目的一些基本信息,本质是一张图片
徽标由第三方驱动,我们要做的是调用它们
其中,herf=后面需要添加的URL是点击徽标后跳转到的地址,src=后面需要添加的URL决定徽标的样子,因此,可以说src是最重要的
示例
<a href="https://github.com/LSPosed/LSPosed/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/LSPosed/LSPosed?label=stars"></a>
<!--
此徽标显示项目的Star数量
-->
<a href="https://github.com/LSPosed/LSPosed/forks"><img alt="GitHub forks" src="https://img.shields.io/github/forks/LSPosed/LSPosed"></a>
<!--
此徽标显示项目的Fork数量
-->
<a href="https://github.com/LSPosed/LSPosed/blob/main/LICENSE"><img alt="GitHub License" src="https://img.shields.io/github/license/LSPosed/LSPosed"></a>
<!--
此徽标显示项目的许可证
-->
<a href="https://github.com/LSPosed/LSPosed/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/LSPosed/LSPosed"></a>
<!--
此徽标显示项目已开启Issue的数量
-->
<a href="https://github.com/LSPosed/LSPosed/discussions"><img alt="GitHub discussions" src="https://img.shields.io/github/discussions/LSPosed/LSPosed"></a>
<!--
此徽标显示项目的Discussions数量
-->
<a href="https://socialify.git.ci/LSPosed/LSPosed/image?font=Rokkitt&forks=1&issues=1&language=1&name=1&owner=1&pattern=Brick%20Wall&pulls=1&stargazers=1&theme=Auto"><img alt="GitHub" src="https://socialify.git.ci/LSPosed/LSPosed/image?font=Rokkitt&forks=1&issues=1&language=1&name=1&owner=1&pattern=Brick%20Wall&pulls=1&stargazers=1&theme=Auto"></a>
<!--
此徽标显示项目Star,Issue,Fork,PR的数量与主要编程语言
-->
<a href="https://www.star-history.com/#LSPosed/LSPosed&Timeline"> <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=LSPosed/LSPosed&type=Timeline"></a>
<!--
此徽标显示项目历史上Star数量的变化趋势
-->
<a href="https://github.com/LSPosed/LSPosed/graphs/contributors"><img src="https://contrib.rocks/image?repo=LSPosed/LSPosed"></a>
<!--
此徽标显示项目贡献者的头像
-->
<a href="https://github.com/LSPosed/LSPosed"><img alt="Repo Card" src="https://github-readme-stats.vercel.app/api/pin/?username=LSPosed&repo=LSPosed"></a>
<!--
此徽标显示项目卡片,风格是github作者的Pinned
-->(PS:由于我的项目无人问津局限性太大,所以我使用LSPosed项目示范。把"LSPosed/LSPosed"换为你们的仓库即可直接使用)
效果
这玩意其实与徽标类似,将上面的src替换一下就好了