jupyter notebook中markdown 使用

Jupyter Notebook Markdown

• Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式，其目标是实现易读易写。因此很多人用它来写博客，还有我们在github上看到的README.md说明文档也是MarkDown写的。
• 我喜欢用jupyter notebook。
• 最近打卡谢了几篇文章， jupyter的Markdown真香， 特别记录一下。

MarkDown语法

标题

使用 # 号可表示 1-6 级标题，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推。
注意：#和后边文字要用空格隔开

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

换行

一个 MD段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（若某一行只包含空格和制表符，则该行也会被视为空行）
「由一个或多个连续的文本行组成」这句话其实暗示了 Markdown 允许段落内的强迫换行（插入换行符）。换行操作方法为在行末添加两个以上空格后回车。

### 错误的换行  
第一行内容
第二行内容

### 正确的换行（有一个以上空行）  
第一行内容

第二行内容

### 正确的换行（行末添加2个以上空格后回车）  

第一行内容  
第二行内容  

效果如下：

错误的换行
第一行内容
第二行内容

正确的换行（有一个以上空行）
第一行内容

第二行内容

正确的换行（行末添加2个以上空格后回车）

第一行内容
第二行内容

换行

单个段落<p>单个段落<br />      
! br 与 /之间有空格

单个段落
! br 与 /之间有空格

文本样式

粗体

**加粗**

效果：加粗

斜体

*斜体*
_斜体_

效果：
斜体 斜体

粗斜体

***粗斜体***
___粗斜体___

效果：

粗斜体
粗斜体

分割线

划横线：html中的

---

，在MD中使用 *** 即可。
在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。
你也可以在底线中间插入空格。下面每种写法都可以建立分隔线。

1---
2***
3___

效果：

---

---

---

删除线

前后加两个弯曲线条~

删除线：~~删除线~~

效果：
删除线

下划线

下划线：使用html语法中的标签来实现
比如： 下划线

效果:
下划线

引用

>引用内容
如果你从别处copy了一段文字，需要用到引用，使用 > 这种尖括号（大于号）即可。
>引用嵌套
>>引用嵌套
>>>引用嵌套

效果

引用内容
如果你从别处copy了一段文字，需要用到引用，使用 > 这种尖括号（大于号）即可。

引用嵌套

引用嵌套

引用嵌套

脚注

脚注[^脚注]

效果：

脚注[^脚注]
脚注[^nnnn]

列表

熟悉HTML的都了解列表分为无序列表和有序列表，MD也分

无序列表：用 - 或 * 都可以

有序列表：用 1.（数字后跟点）即可

无序列表使用+或者-或者*来标记
* 第一行
* 第二行
* 第三行
—
- 第一行
- 第二行
- 第三行
—
+ 第一行
+ 第二行
+ 第三行

效果：

• 第一行
• 第二行
• 第三行

---

• 第一行
• 第二行
• 第三行

---

• 第一行
• 第二行
• 第三行

效果：

第一行
第二行
第三行
第一行
第二行
第三行
第一行
第二行
第三行

有序列表

有序列表使用数字加上.来实现。注意我将数字3和2换了位置。
1. 第一行
3. 第二行
2. 第三行

效果：

1. 第一行
2. 第二行
3. 第三行

列表嵌套
1. 列表嵌套
- 列表嵌套
+ 列表嵌套
2. 列表嵌套
* 列表嵌套
- 列表嵌套

效果：

1. 列表嵌套
   • 列表嵌套
   • 列表嵌套
2. 列表嵌套
   • 列表嵌套
   • 列表嵌套

插入链接与插入图片的语法很像，区别在一个!号

插入图片时需要图片的地址，如果你是在网上写blog等，必须使用url；如果你在本地使用MD编辑器做记录，可以使用本地路径

插入图片和链接的方式有两种：1.行内方式 2.关联方式

图片

使用Markdown将图像插入文章，你需要在Markdown编辑器输入 ![图片标题]和(图片链接)。 这时在预览面板中会自动创建一个图像上传框。你可以从电脑桌面拖放图片(.png, .gif, .jpg)到上传框, 或者点击图片上传框使用标准的图像上传方式。 如果你想通过链接插入网络上已经存在的图片，只要单击图片上传框的左下角的“链接”图标，这时就会呈现图像URL的输入框。想给图片添加一个标题, 你需要做的是将标题文本插图中的方括号。

本地图片也可以直接拖动到要插入的位置，截图直接复制就行，不需要其他操作。


代码

MD 如果是段落上的一个函数或片段的代码可以用两个`(在tab键的上面)把它包起来。
Jupyter MD中我用是/<code> /</code> 包围代码。
    
代码与代码块

一般使用两个 ` 或 两个 ```把代码包裹起来，包裹起来的文字会保持它原有的格式。

代码：使用 ` 包裹起来的代码，可以显示在行内，代码不会高亮。

代码块：使用 ```包裹起来的代码，另起一行显示，可以说明编程语言，可能会出现代码高亮。

如果是代码块的话可以使用三个~或者`，然后回车，右下角也可以选择语言。
    
Jupyter MD中我用是/<code> /</code> 包围代码。
    

print('hello')

print('hello')
print('world')

print('hello') print('hello') print('hello')

自动链接

MD支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如： <http://example.com/>

http://example.com/

超链接

[链接名称] (链接地址) 或者直接使用<链接地址>

这是一个超链接[百度](https://www.baidu.com)

百度

表格

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

效果：

表头	表头
单元格	单元格
单元格	单元格

:-设置内容和标题栏居左对齐。
:–:设置内容和标题栏居中对齐。
–:设置内容和标题栏居右对齐。

转义

在MD中，有一些符号是有特殊意义的，比如 # ，如果你直接输入“# 你好”，将会变成一级标题。这时候需要使用\来转义，可以在井号之前加入反斜杠，如\#，才能得到你想要的结果。

MD支持以下这些特殊符号前面加上反斜杠来帮助插入普通的符号。

\   反斜线  
`   反引号  
*   星号  
 _   底线  
{}  花括号  
[]  方括号  
()  括弧  
#   井字号  
+   加号  
-   减号  
.   英文句点  
!   惊叹号  

缩进

用 tab键。

用 tab键缩进。

https://www.cnblogs.com/liufei-kuaile/p/7397471.html
https://blog.csdn.net/weixin_42575877/article/details/106176289
https://www.jianshu.com/p/576e3f1049f8