本文概述
Markdown是一种轻量级流行的Markup语言, 它是数据科学家和分析人员的写作标准。它通常被Markdown处理器转换为相应的HTML, 从而使它可以在不同的设备和人们之间轻松共享。
标记语言类似于由标记标记组成的超文本标记语言(HTML), 它由开始标记<tagname>和结束标记</ tagname>组成。
在本教程中, 你可以看到使用标记标签获得的相同结果, 以及Jupyter Notebook支持的Markdown语法。
标题
块引用
代码部分
数学符号
越线
粗体和斜体文字
水平线
有序列表
无序列表
内部和外部链接
表格
图片
你需要拥有Jupyter Notebook, 可以使用srcmini的教程：Jupyter Notebook教程：权威指南来设置环境。
插入新单元格后, 可以使用下拉菜单或键盘快捷键” m / M”在Jupyter Notebook中选择Markdown单元格。
标题
标题以’＃’开头, 即哈希符号后跟空格, 并且有六个标题, 最大的标题仅使用一个哈希符号, 最小的标题使用六个哈希符号。
＃(标题1, 标题)
##(标题2, 主要标题)
###(标题3, 子标题)
####(标题4)
#####(标题5)
######(标题6)“
或者, 标题可以以以下标记从标记标签开始, 即从h1到h6。
<h1>标题1, 标题<h1>
<h2>标题2, 主要标题<h2>
<h3>标题3, 副标题<h3>
<h4>标题4 <h4>
<h5>标题5 <h5>
<h6>标题6 <h6>
单击工具栏中的”运行”后, 以上两种语法都可以将标题从h1渲染为h6。
块引用
块引用可以容纳大部分文本, 通常会缩进。可以通过使用Markdown符号’>’或<blockquote> text for blockquote </ blockquote>来获得它们。
- >这很好
- <blockquote>这很好</ blockquote>
单击工具栏中的”运行”后, 以上两种语法都可以以缩进形式呈现文本。
代码部分
“代码”部分是指定不同编程语言的代码的部分, 可以在内联代码以”`内联代码去这里”开头的情况下呈现, 但其代码块以三个内引号开头。 “块行代码在这里“`’。另外, “代码”部分的标记标签是” <代码>代码在这里<代码>”。
内联代码示例如下：
x = 5
单击”运行”后, 你可以看到内联代码, 并突出显示该代码。
代码节示例如下：
使用降价
Python
str =”这是块级代码”
打印(STR)
“`
使用标记标签
<code> Python
str =”这是一个块级代码”
打印(STR)
</ code>
使用Markdown, 如果在”`”三勾后提到编程语言名称, 则可以得到代码的语法高亮显示, 并且示例如下：
使用Markdown, 不会突出显示语法, 但是会突出显示代码：
数学符号
Markdown中的数学符号包含在美元符号中的” \ $数学表达式在此处\ $”中, 在Markup中, 你可以单击此链接以获取更多详细信息：数学运算符。你可以在下面看到使用数学符号的示例。
\ $ \ sqrt {k} $
上面的示例将以粗体格式显示数学表达式。
越线
换行标记以<br>标记开头, 没有结束标记, 以使该行断开, 其余内容以换行开头, 如下所示。
The line breaks after using <br> br tags and it is awesome.
单击工具栏中的”运行”后, 你可以在使用<br>标记后看到换行符。其余文本以新行开头。
粗体和斜体文字
你可以使用<b>标记, ” **”即”双星号”或” __”即”双下划线”来获取具有以下语法的粗体文本。
<b>这是粗体字</ b>
**这是粗体字
__这是粗体字
单击工具栏中的”运行”后, 以上所有语法均可呈现粗体文本。
你可以使用<i>标记, 即” *”(即单个星号)或” _”(即单个下划线)来获取以下语法的斜体文本。
<i>这是斜体文本</ i>
*这是斜体文字
_这是斜体文字
在工具栏中单击”运行”后, 以上所有语法均可呈现斜体文本。
水平线
你可以使用Markdown’—‘三个连字符或Markup标签<hr>获得一条水平线。
单击”运行”后, 以上两种语法都会在一端到另一端之间绘制水平线。
有序列表
“有序列表”是带编号的列表, 该列表是通过在<li>和</ li>标记之间的所需项目以<ol>标记开始并以</ ol>标记结束而获得的。标签, 即” ol”是有序列表的缩写, 而” li”是列表项的缩写。例如, 你可以在下面看到包含杂货店清单项目的有序列表。
<01>
<li>鱼</ li>
<li>Eggs</li>
<li>Cheese</li>
</ 01>
或者, 你可以按” 1″列出。 ‘, 即所需的数字, 后跟空格, 下面是示例。
- 鱼
- 蛋
- 起司
单击工具栏中的”运行”后, 以上两种语法都可以显示编号列表。
无序列表
“无序列表”是项目符号列表, 可以使用<ul>标记并以</ ul>标记结尾, 请参见以下示例：
<UL>
<li>鱼</ li>
<li>Eggs</li>
<li>Cheese</li>
</ UL>
另外, “无序”列表可以以带空格的”-“符号开头, 以黑色圆圈表示, 也可以以带空格的” *”符号开头, 以黑色方框表示。
-鱼
– 蛋
– 起司
上面的示例显示了项目符号列表, 其中包含”-“符号, 后跟空格, 并带有黑色圆圈符号。
在工具栏中单击”运行”后, 以上两种语法都可以呈现相同的以下结果, 其中列表中的项目显示在黑色圆圈中。
内部和外部链接
Markdown中的内部链接以<a>标记开头, 该标记具有由属性” id”定义的唯一ID, 可以在笔记本中使用以下示例进行链接：
<a id=”division_ID”文本在此处></a>
同样, 可以通过遵循使链接可单击的代码, 将上面定义的ID链接到笔记本的此部分。
[部分标题](＃division_ID)
在下面的示例中, 可以看到上面的示例, 其中定义的ID与在工具栏中单击”运行”后获得的部分和可单击链接链接。
Markdown中的外部链接以<a>开头, 并以<a>标记结束, 即, <a>代表定义链接的锚, 并且具有属性” href”(也称为超引用), 其中包含链接的目标地址或标签之间的URL和文本是可见的, 并且可以单击以打开目标地址, 如下所示。
<a> href =” https://www.google.com”>链接到Google </a>
或者, 也可以以__ [文本链接](网站的网址)__开头, 其中双下划线在两边, 文本链接括在方括号中, 网站的网址括在括号中, 后跟网址。
连结至Google
上面的两种语法都可以在下面呈现相同的结果, 在该位置中, 单击工具栏中的”运行”后, 可单击和带下划线的文本可以导致新页面。
表格
该表包含行和列中的信息, 并由” |”组合而成也就是说, “垂直管道”用于分隔各列, 而”-“即是连字符, 以创建标题, 其中的空白行即垂直管道和破折号的组合呈现了表格格式。
另外, 你可以通过大致与列对齐来更改单元格, 笔记本将自动调整给定单元格中内容的大小。
|名称|地址|薪水| | —– | ——- | —— | |汉娜|布里斯班| 4000 | ||亚当|悉尼| 5000 |
或者, 可以使用Markdown构建表, 其中<table>用于定义宽度为百分比的表。<tr>设置表行, 该行给出居中文本的粗体以及表标题, 由<th>描述表格顶部的其他内容由<td>设置, 即表格数据标签。
<table style =” width：20％”>
<tr>
<th> <Name> </ th>
<th> <地址> </ th>
<th> <Salary> </ th>
</ tr>
<tr>
<td> <Hanna> </ td>
<td> <布里斯班> </ td>
<td> <4000> </ td>
</ tr>
<tr>
<td> <Adam> </ td>
<td> <悉尼> </ td>
<td> <5000> </ td>
</ tr>
</ table>
单击工具栏中的”运行”后, 以上两种语法都可以呈现相同的以下结果。
图片
你可以通过从”编辑”菜单中选择”插入图像”来从工具栏中插入图像, 并可以浏览所需的图像, 如下所示。
该图像可以包含带有源的Markdown标签<img>, 即源代码, 即src作为属性, 它包含具有可选属性(例如宽度和高度)的图像链接, 如下所示。
<img> <src =” https://i.imgur.com/WWrydEh.png”宽度=” 500″高度= 500>
单击工具栏中的”运行”后, 以上两个过程都可以渲染相同的图像。
总结
在本教程中, 你了解了不同的标记标签, 这些标记是由标记语言定义的, 并且还与Jupyter Notebook特有的Markdown单元有关的语法, 该语法与代码一起使用, 可以更有效地描述内容。
如果你想了解有关Markdown的更多信息, 请参阅Markdown Guide。
