个性化阅读
专注于IT技术分析

Jupyter Notebook中的Markdown使用教程

本文概述

Markdown是一种轻量级流行的Markup语言, 它是数据科学家和分析人员的写作标准。它通常被Markdown处理器转换为相应的HTML, 从而使它可以在不同的设备和人们之间轻松共享。

标记语言类似于由标记标记组成的超文本标记语言(HTML), 它由开始标记<tagname>和结束标记</ tagname>组成。

在本教程中, 你可以看到使用标记标签获得的相同结果, 以及Jupyter Notebook支持的Markdown语法。

标题

块引用

代码部分

数学符号

越线

粗体和斜体文字

水平线

有序列表

无序列表

内部和外部链接

表格

图片

你需要拥有Jupyter Notebook, 可以使用srcmini的教程:Jupyter Notebook教程:权威指南来设置环境。

插入新单元格后, 可以使用下拉菜单或键盘快捷键” m / M”在Jupyter Notebook中选择Markdown单元格。

Jupyter Notebook中的Markdown1

标题

标题以’#’开头, 即哈希符号后跟空格, 并且有六个标题, 最大的标题仅使用一个哈希符号, 最小的标题使用六个哈希符号。

#(标题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。

Jupyter Notebook中的Markdown2

块引用

块引用可以容纳大部分文本, 通常会缩进。可以通过使用Markdown符号’>’或<blockquote> text for blockquote </ blockquote>来获得它们。

  • >这很好
  • <blockquote>这很好</ blockquote>

单击工具栏中的”运行”后, 以上两种语法都可以以缩进形式呈现文本。

Jupyter Notebook中的Markdown3

代码部分

“代码”部分是指定不同编程语言的代码的部分, 可以在内联代码以”`内联代码去这里”开头的情况下呈现, 但其代码块以三个内引号开头。 “块行代码在这里“`’。另外, “代码”部分的标记标签是” <代码>代码在这里<代码>”。

内联代码示例如下:

x = 5

单击”运行”后, 你可以看到内联代码, 并突出显示该代码。

Jupyter Notebook中的Markdown4

代码节示例如下:

使用降价

Python

str =”这是块级代码”

打印(STR)

“`

使用标记标签

<code> Python

str =”这是一个块级代码”

打印(STR)

</ code>

使用Markdown, 如果在”`”三勾后提到编程语言名称, 则可以得到代码的语法高亮显示, 并且示例如下:

Jupyter Notebook中的Markdown5

使用Markdown, 不会突出显示语法, 但是会突出显示代码:

Jupyter Notebook中的Markdown6

数学符号

Markdown中的数学符号包含在美元符号中的” \ $数学表达式在此处\ $”中, 在Markup中, 你可以单击此链接以获取更多详细信息:数学运算符。你可以在下面看到使用数学符号的示例。

\ $ \ sqrt {k} $

上面的示例将以粗体格式显示数学表达式。

Jupyter Notebook中的Markdown7

越线

换行标记以<br>标记开头, 没有结束标记, 以使该行断开, 其余内容以换行开头, 如下所示。

The line breaks after using <br> br tags and it is awesome.

单击工具栏中的”运行”后, 你可以在使用<br>标记后看到换行符。其余文本以新行开头。

Jupyter Notebook中的Markdown8

粗体和斜体文字

你可以使用<b>标记, ” **”即”双星号”或” __”即”双下划线”来获取具有以下语法的粗体文本。

<b>这是粗体字</ b>

**这是粗体字

__这是粗体字

单击工具栏中的”运行”后, 以上所有语法均可呈现粗体文本。

Jupyter Notebook中的Markdown9

你可以使用<i>标记, 即” *”(即单个星号)或” _”(即单个下划线)来获取以下语法的斜体文本。

<i>这是斜体文本</ i>

*这是斜体文字

_这是斜体文字

在工具栏中单击”运行”后, 以上所有语法均可呈现斜体文本。

Jupyter Notebook中的Markdown10

水平线

你可以使用Markdown’—‘三个连字符或Markup标签<hr>获得一条水平线。

单击”运行”后, 以上两种语法都会在一端到另一端之间绘制水平线。

Jupyter Notebook中的Markdown11

有序列表

“有序列表”是带编号的列表, 该列表是通过在<li>和</ li>标记之间的所需项目以<ol>标记开始并以</ ol>标记结束而获得的。标签, 即” ol”是有序列表的缩写, 而” li”是列表项的缩写。例如, 你可以在下面看到包含杂货店清单项目的有序列表。

<01>

<li>鱼</ li>

<li>Eggs</li>

<li>Cheese</li>

</ 01>

或者, 你可以按” 1″列出。 ‘, 即所需的数字, 后跟空格, 下面是示例。


  1. 起司

单击工具栏中的”运行”后, 以上两种语法都可以显示编号列表。

Jupyter Notebook中的Markdown12

无序列表

“无序列表”是项目符号列表, 可以使用<ul>标记并以</ ul>标记结尾, 请参见以下示例:

<UL>

<li>鱼</ li>

<li>Eggs</li>

<li>Cheese</li>

</ UL>

另外, “无序”列表可以以带空格的”-“符号开头, 以黑色圆圈表示, 也可以以带空格的” *”符号开头, 以黑色方框表示。

-鱼

– 蛋

– 起司

上面的示例显示了项目符号列表, 其中包含”-“符号, 后跟空格, 并带有黑色圆圈符号。

在工具栏中单击”运行”后, 以上两种语法都可以呈现相同的以下结果, 其中列表中的项目显示在黑色圆圈中。

Jupyter Notebook中的Markdown13

内部和外部链接

Markdown中的内部链接以<a>标记开头, 该标记具有由属性” id”定义的唯一ID, 可以在笔记本中使用以下示例进行链接:

<a id=”division_ID”文本在此处></a>

同样, 可以通过遵循使链接可单击的代码, 将上面定义的ID链接到笔记本的此部分。

[部分标题](#d​​ivision_ID)

在下面的示例中, 可以看到上面的示例, 其中定义的ID与在工具栏中单击”运行”后获得的部分和可单击链接链接。

Jupyter Notebook中的Markdown14

Markdown中的外部链接以<a>开头, 并以<a>标记结束, 即, <a>代表定义链接的锚, 并且具有属性” href”(也称为超引用), 其中包含链接的目标地址或标签之间的URL和文本是可见的, 并且可以单击以打开目标地址, 如下所示。

<a> href =” https://www.google.com”>链接到Google </a>

或者, 也可以以__ [文本链接](网站的网址)__开头, 其中双下划线在两边, 文本链接括在方括号中, 网站的网址括在括号中, 后跟网址。

连结至Google

上面的两种语法都可以在下面呈现相同的结果, 在该位置中, 单击工具栏中的”运行”后, 可单击和带下划线的文本可以导致新页面。

Jupyter Notebook中的Markdown15

表格

该表包含行和列中的信息, 并由” |”组合而成也就是说, “垂直管道”用于分隔各列, 而”-“即是连字符, 以创建标题, 其中的空白行即垂直管道和破折号的组合呈现了表格格式。

另外, 你可以通过大致与列对齐来更改单元格, 笔记本将自动调整给定单元格中内容的大小。

|名称|地址|薪水| | —– | ——- | —— | |汉娜|布里斯班| 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>

单击工具栏中的”运行”后, 以上两种语法都可以呈现相同的以下结果。

Jupyter Notebook中的Markdown16

图片

你可以通过从”编辑”菜单中选择”插入图像”来从工具栏中插入图像, 并可以浏览所需的图像, 如下所示。

Jupyter Notebook中的Markdown17
Jupyter Notebook中的Markdown18

该图像可以包含带有源的Markdown标签<img>, 即源代码, 即src作为属性, 它包含具有可选属性(例如宽度和高度)的图像链接, 如下所示。

<img> <src =” https://i.imgur.com/WWrydEh.png”宽度=” 500″高度= 500>

单击工具栏中的”运行”后, 以上两个过程都可以渲染相同的图像。

Jupyter Notebook中的Markdown19

总结

在本教程中, 你了解了不同的标记标签, 这些标记是由标记语言定义的, 并且还与Jupyter Notebook特有的Markdown单元有关的语法, 该语法与代码一起使用, 可以更有效地描述内容。

如果你想了解有关Markdown的更多信息, 请参阅Markdown Guide。

赞(2)
未经允许不得转载:srcmini » Jupyter Notebook中的Markdown使用教程

评论 抢沙发

评论前必须登录!