markdown文档:一个简单标记语言的使用及GitHub实际应用
目录
1.什么是Markdown?
2.Markdown与HTML的简单对比
3.Markdown的基本语法
4.GitHub中Markdown的使用
4.1.GitHub上自定义的md文件格式与markdown pad(IDE)的区别,
4.2.GitHub上超链接的使用方法(遇到的错误及修改)
5.应用:论文项目中YOLOV5的md文档
参考文献
1.什么是Markdown?
Markdown是一种轻量级的标记语言(lightweight markup language),并不是编程语言,它用于使用纯文本编辑器创建格式化文本。主要用于博客,即时消息,在线论坛,协作软件,文档页面和自述文件。Markdown 是一种最小的标记语言,可以使用普通的文本编辑器进行读取和编辑,但有专门设计的编辑器可以使用样式预览文件,这些样式适用于所有主要平台【1】。
Markdown 是一种用来书写网页内容的方法。它实际上在使用我们在日常生活中用来书写和发送信息的纯文本格式来书写。纯文本仅由常见的字母、文字和一些特殊符号来构成,例如星号(\*
)和反引号(`
)。
2.Markdown与HTML的简单对比
3.Markdown的基本语法
3.1.斜体和加粗(Italics and Bold)
斜体:句子或单词前后加下划线 : _ 内容 _
实例1
加粗: 使用两个星号写到文本前后: **内容**
实例2
斜体和加粗混用实例3
实例4:加粗的同时设置为斜体,虽然不分顺序,但是第二个相对更容易区分。
3.2.标题
这里有6种不同的标题,他们的大小递减
在Markdown里面添加标题,你要在文本的前面添加一个井号 (#
)。 你可以键入多个井号来生成你想要的几级标题。 例如,一级标题你需要添加一个井号 (# 一级标题
), 当你需要一个三级标题时你就要三个井号 (### 三级标题
).
实例5
- 不能将标题加粗,但是可以将其中的文字设置为斜体。
3.3.超链接
在 Markdown 中有两种不同的链接种类,分为内联链接和全局链接,但是它们的渲染方式完全相同。
3.3.1内联链接
内联链接:创建一个内联的链接, 你需要将被链接的文本用方括号 ( [ ]
)包起来, 然后将链接地址用圆括号 ( ( )
)起来。 *这些括号及以后出现的括号均为英文半角符号,译者注。 比方说,创建一个写着 "Visit Github!" 到 www.github.com 的超链接, 你应该使用Markdown这样书写: [Visit GitHub!](www.github.com)
.
实例6
实例7:加粗局部,整句话连接到新链接
实例8:标题设置为四号,然后将短语"the BBC" 链接到 www.bbc.com/news:
3.3.2.全局链接
另外一种链接叫做 全局 链接,也就是这个链接链接到文档的另外一个位置。格式如下
[内容1][网址名称1].[内容2][网址名称2].[内容3][网址名称1]. #内容为链接的单词或句子,网址名称为定点名称,下面为定点名称指向的网址。[网址名称1]: www.github.com[网址名称2]: www.google.com#优点:减少链接重复
上面的“全局”链接是第二组方括号: [another place]
和 [another-link]
。在Markdown文档的底部, 这些方括号被适当的定义为外部网页链接。使用全局链接的一个优点是如果文档中有多个指向统一网址的链接只需要书写或更新一次。 例如,我们觉得将所有的 [another place]
链接到其它的地方,我们只需要更改那一个全局链接即可。
全局链接本身不会被Markdown渲染出来,需要提供同名的用方括号包裹的标签来定义它们,然后是冒号,然后是链接。[内容]:链接
实例9:在底部的文本框,写一些全局链接。将第一个链接命名为 "a fun place", 然后将它链接到 www.zombo.com;将第二个链接到 www.stumbleupon.com。
3.4.图片
添加图片也有两种方法,分为内联图片链接和。就像链接一样,并且渲染出来的结果是一样的。 添加链接和图片的区别仅仅在于前面的感叹号 ( !
)。![内容](链接)
3.4.1.内联图片链接
第一种图片的格式叫做 内联图片链接。创建一个内联的图片链接, 需要输入一个感叹号 ( !
)将方括号 ( [ ]
)中的描述性文本包起来, 然后使用圆括号 ( ( )
)包链接地址。 (描述性文本是为查看解释图片短语或者句子的语句。)
实例10:创建一个描述文本为"Benjamin Bannekat"的内联的链接地址为 https://octodex.github.com/images/bannekat.png 的图片, 应该这样写Markdown: ![Benjamin Bannekat](https://octodex.github.com/images/bannekat.png)
。
实例11:在下面的文本框里面,将链接转换为图片,并且在方括号内填写描述文本"A pretty tiger":
3.4.2.全局图片链接
对于全局图片来说,使用同样的标签模式。在标记前添加一个感叹号然后跟两个方括号。 对于描述文本来说,应该添加两个或以上的图片标签,比如这样: ![The founding father][Father]
在Markdown页面的底部, 定义一个图片标签,就像这样: [Father]: http://octodex.github.com/images/founding-father.jpg
.
实例12:在文本框底部,放置了一些全局图像; 给第一个全局图片标签命名为 "Black", 然后把它链接到 https://upload.wikimedia.org/wikipedia/commons/a/a3/81_INF_DIV_SSI.jpg
; 给第二个图片链接到http://icons.iconarchive.com/icons/google/noto-emoji-animals-nature/256/22221-cat-icon.png
。
3.5.引用块
如果需要为其他来源的内容添加特殊的格式来引起读者的注意, 或为其他杂志的文章设计特殊的格式,那么 Markdown 的引用块语法将会非常有用。 引用块是一个拥有特殊格式的句子或段落,为了引起读者的注意。例如:
“无为而治的罪是所有七种罪中最致命的。有传言说,要使邪恶的人实现其目的,只需要好人无所事事。”
要创建一个引用块,只需要在行首添加大于号(>
)。>内容
实例13:
实例14: 可以在每一行引用前都添加一个大于号。 当有多个段落时,他就是一个整体的块。
实例15:以上内容的全部应用、斜体,加粗,图片,超链接
3.6.列表
这个世界上有俩种不同的列表:无序列表和有序列表。 无序列表前是黑点,有序列表前是数字。
要创建一个无序列表,需要在每一个列表项前加一个星号( *
)。 每个列表要占一行。例如,一个杂货店商品的列表可以用 Markdown 写成这样* 内容:
* 牛奶 * 鸡蛋 * 三文鱼 * 黄油
这个 Markdown 列表将会显示成这样:
- 牛奶
- 鸡蛋
- 三文鱼
- 黄油
实例16
注意:中间一定要加空格
实例17:有序列表
注意:数字+点 后一定要加空格
实例18:无序列表和斜体,加粗,链接一起的实现
如果需要将一个列表变得更深,或者,将一个列表放置在另一个列表中。 不用担心,因为 Markdown 的语法完全相同。 只需要在每个星号前比上一个项目多缩进一个空格。
实例19:将人物的特征变成子列表。
3.7.段落
分为段落换行和段落间换行。可以通过在每一行的结尾输入俩个空格来实现这一点。 空格是不可见的,输入的内容就像这样:
我有自相矛盾么?·· 很好,那我是在自相矛盾了,·· (我是庞大的,我承载着很多个自己。)
每个点( ·
)都代表一个空格:内容+空格。
实例20
- 注意:是空格,不是点
4.GitHub中Markdown的使用
4.1.GitHub上自定义的md文件格式与markdown pad(IDE)的区别,
markdown pad(IDE)
* 代表列表
GitHub上自定义的md文件:
- 代表列表
- 超链接如果不生效的话,需要顶头
- GitHub仓库可直接引用作网页
4.2.github上超链接的使用方法(遇到的错误及修改)
错误1:markdown的超链接无法生效
解决办法:超链接如果不生效的话,需要顶格(如图)
显示为:
5.应用:论文项目中YOLOV5的md文档
<div align="center">
<p><a align="left" href="https://ultralytics.com/yolov5" target="_blank"><img width="850" src="https://github.com/ultralytics/yolov5/releases/download/v1.0/splash.jpg"></a>
</p>
<br>
<div><a href="https://github.com/ultralytics/yolov5/actions"><img src="https://github.com/ultralytics/yolov5/workflows/CI%20CPU%20testing/badge.svg" alt="CI CPU testing"></a><a href="https://zenodo.org/badge/latestdoi/264818686"><img src="https://zenodo.org/badge/264818686.svg" alt="YOLOv5 Citation"></a><a href="https://hub.docker.com/r/ultralytics/yolov5"><img src="https://img.shields.io/docker/pulls/ultralytics/yolov5?logo=docker" alt="Docker Pulls"></a><br><a href="https://colab.research.google.com/github/ultralytics/yolov5/blob/master/tutorial.ipynb"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open In Colab"></a><a href="https://www.kaggle.com/ultralytics/yolov5"><img src="https://kaggle.com/static/images/open-in-kaggle.svg" alt="Open In Kaggle"></a><a href="https://join.slack.com/t/ultralytics/shared_invite/zt-w29ei8bp-jczz7QYUmDtgo6r6KcMIAg"><img src="https://img.shields.io/badge/Slack-Join_Forum-blue.svg?logo=slack" alt="Join Forum"></a>
</div>
<br>
<div align="center"><a href="https://github.com/ultralytics"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-github.png" width="2%"/></a><img width="2%" /><a href="https://www.linkedin.com/company/ultralytics"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-linkedin.png" width="2%"/></a><img width="2%" /><a href="https://twitter.com/ultralytics"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-twitter.png" width="2%"/></a><img width="2%" /><a href="https://youtube.com/ultralytics"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-youtube.png" width="2%"/></a><img width="2%" /><a href="https://www.facebook.com/ultralytics"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-facebook.png" width="2%"/></a><img width="2%" /><a href="https://www.instagram.com/ultralytics/"><img src="https://github.com/ultralytics/yolov5/releases/download/v1.0/logo-social-instagram.png" width="2%"/></a>
</div><br>
<p>
YOLOv5
markdown文档:一个简单标记语言的使用及GitHub实际应用相关推荐
- linux 如何查看终端格式,你应该还不知道,Linux终端下的 Markdown 文档查看器
原标题:你应该还不知道,Linux终端下的 Markdown 文档查看器 现在,Markdown 差不多已经成为技术文档的标准.它可以实现技术文档的快捷写作,以及输出发布.同样都是标记语言,但Mark ...
- linux文档查看器翻译,mdv – Linux终端下的 Markdown 文档查看器
现在,Markdown 差不多已经成为技术文档的标准.它可以实现技术文档的快捷写作,以及输出发布.同样都是标记语言,但Markdown 文档相比HTML更加简单.一是体现在标记符的数量上,二是体现在标 ...
- Python 实现将 Markdown 文档转换为 EPUB 电子书文件
Python 实现将 Markdown 文档转换为 EPUB 电子书文件 Markdown Markdown 是一种轻量级的标记语言,用于以简单且易于阅读的方式格式化文本.它由 John Gruber ...
- C#解析Markdown文档,实现替换图片链接操作
前言 又是好久没写博客了 其实也不是没写,是最近在「做一个博客」,从2月21日开始,大概一个多星期的时间,疯狂刷进度,边写代码边写了一整系列的博客开发笔记,目前为止已经写了16篇了,然后上3月之后工作 ...
- 【Markdown使用技巧总结】-如何在Markdown文档中插入空格?
插入空格方法 我们知道跟word等其他编辑器不同,Markdown只能识别一个空格(在半角输入状态下),那要怎么输入空格呢? 1.巧用html的空格 &emsp: &ensp: &am ...
- 在HBuilder中编辑markdown文档(原)
最近才真正意识到markdown的神奇.本篇内容主要部分来自HBuilderX自带的markdown语法帮助,加入了一些自己认为很实用的使用方法. 目 录 自动生成目录 返回目录 生成html页面 引 ...
- 一款好用的Markdown文档编辑器:Typora
Markdown是一种不依赖特定工具.特定平台的标记方法.你可以随手打开一个notepad来写,也可以在任何支持文本输入的网页上写. ● Markdown 是一种轻量级标记语言,它允许人们使用易读易写 ...
- python下载图片到文件夹_python实现解析markdown文档中的图片,并且保存到本地~
背景 前阵子简书好像说是凉了,搞得我有点小慌,毕竟我的大部分博客都是放在简书上面的,虽然简书提供了打包导出功能,但是只能导出文字,图片的话还是存在简书服务器上面,再加上我一直想要重新做一个个人博客,于 ...
- VScode编辑同步Markdown文档到印象笔记
VScode编辑同步Markdown文档到印象笔记 第一步 下载VSCode 到Visual Studio Code官网下载VSCode,并安装 第二步 安装VScode相关插件 需要两个插件: ev ...
- 【效率工具】markdown文档自动同步到印象笔记evernote
本地markdown文档同步印象笔记 在本地使用 MarkdownPad.Mark.Typora.VSCode 任意你喜欢的 Markdown 编辑器进行文档编写,本工具将自动同步文档到印象笔记.可以 ...
最新文章
- 你可能不知道的 IDEA 高级调试技巧
- 超图学习综述: 算法分类与应用分析
- 关于Python中的yield(转载)
- 开启DELL Raid卡H730P缓存
- FPGA车牌数字识别系统设计verilog实现(带上板录制视频)
- CF700E-Cool Slogans【SAM,线段树合并,dp】
- const char * 类型的实参与 char * 类型的形参不兼容_4 种 C++ 强制类型转换,你都清楚吗?...
- 计算机组成的ir是指,2002.10计算机组成原理§1控制器的基本概念⑵指令寄存器IR指令.ppt...
- 看着自己参与的自测,我简直要疯了…………
- .net core @Html 自定义属性中包含特殊符号解决
- 论文阅读-目标检测(2019)-CenterNet:目标检测转化为关键点检测及其属性回归
- mysql插入图片_如何向MySQL中插入图片文件
- 23 岁那年你正处在哪个状态?现在呢?
- 设计心理学之色彩心理学和马斯洛需求层次理论
- 涅普计划-web入门简介笔记
- python控制键盘鼠标库pynput基本操作
- 俄罗斯方块游戏开发(VC++ mfc dialog模式)
- 目标检测YOLO实战应用案例100讲-基于深度学习的自动驾驶车辆三维目标检测方法研究与应用
- 仿“真心祝福你”微信小程序源码
- 高博-《视觉SLAM十四讲》
热门文章