Jupyter Notebook中的Markdown使用教程 _Markdown

本文概述

标题
块引用
代码部分
数学符号
越线
粗体和斜体文字
水平线
有序列表
无序列表
内部和外部链接
表格
图片
总结

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链接到笔记本的此部分。
[部分标题](＃d??ivision_ID)
在下面的示例中, 可以看到上面的示例, 其中定义的ID与在工具栏中单击” 运行” 后获得的部分和可单击链接链接。

文章图片
Markdown中的外部链接以< a> 开头, 并以< a> 标记结束, 即, < a> 代表定义链接的锚, 并且具有属性” href” (也称为超引用), 其中包含链接的目标地址或标签之间的URL和文本是可见的, 并且可以单击以打开目标地址, 如下所示。
< a> href =http://www.srcmini.com/” 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 =http://www.srcmini.com/” https://i.imgur.com/WWrydEh.png” 宽度=” 500″ 高度= 500>
单击工具栏中的” 运行” 后, 以上两个过程都可以渲染相同的图像。

文章图片
总结在本教程中, 你了解了不同的标记标签, 这些标记是由标记语言定义的, 并且还与Jupyter Notebook特有的Markdown单元有关的语法, 该语法与代码一起使用, 可以更有效地描述内容。
【Jupyter Notebook中的Markdown使用教程】如果你想了解有关Markdown的更多信息, 请参阅Markdown Guide。