jupyter notebook是一个比较比较不错的网页版python编辑器,但是,由于很多“技术文档”都是直接以markdown(.md格式的文件)的格式编写的,而且jupyter notebook的代码文件(.ipynb)也可以转换成.md格式的文件,更为重要的是,我们从github上下载的很多学习资料也都是.md文件格式的。因此,为了能够在jupyter notebook上实现:
- 使用
jupyter notebook浏览技术文档; - 将转换成.md格式的python代码在不用转换格式的情况下直接由
jupyter notebook上打开并且运行代码; - 更加方便的由
jupyter notebook看github下载的资料。
我们需要在jupyter notebook中加入能够阅读.md文件的功能。
安装流程:
anaconda的下载与安装;- 如果在windows环境下需要配置一下
anaconda的环境变量,即将anaconda安装目录的bin目录在环境变量中进行设置; - 现在,你就可以使用
anaconda的命令conda,使用命令conda create -n torch python=3.6;(其中的torch是你所设置的环境名称,以后你可以将自己工作所需要的python库在该环境下下载,它可以根据自己的需求修改;python=3.6 是对该环境下所需的python版本的配置,可以根据需求修改) - 命令
conda activate torch,激活刚才创建的环境,相当于进入到该环境下,如果要退出该环境,可以使用conda deactivate;(但是,我在windows环境下使用时,不需要加前面的conda,自己可以试一试) - 进入刚才创建的环境后,
jupyter notebook命令打不开相应的编辑器,因此我们需要安装它,安装命令conda install jupyter notebook; - 安装成功后,使用命令
jupyter notebook,就会弹出一个网页,并且将该目录的内容在在网页端编辑器中显示出来;(如图所示,是我打开的一个jupyter notebook编辑器,对于每一个文件,都能打开并且进行编辑)

- 但是,当我们打开一个md文件时,仅仅只会显示markdown格式的源码,无法显示渲染后的格式,因此,我们需要为
jupyter notebook添加可以相应的功能,
pip install notedown,下载notedown;- 修改jupyter notebook的配置文件
C:\用户\jluaa\.jupyter\jupyter_notebook_config.py:添加c.NotebookApp.contents_manager_class = 'notedown.NotedownContentsManager';如果是ubuntu系统,在~/.jupyter/jupyter_notebook_config.py中,有时需要命令jupyter notebook --generate-config生成该配置文件;(前面无需加#) - 之后,通过
jupyter notebook编辑器就能实现打开md文件的功能。
注意
本人在配置好上述所示的jupyter_notebook_config.py文件后,在做其他项目时,另外创建了一个环境,下载好jupyter notebook后启动时,有如下报错:
[C 07:13:23.105 NotebookApp] Bad config encountered during initialization:
[C 07:13:23.105 NotebookApp] The 'contents_manager_class' trait of <notebook.notebookapp.NotebookApp object at 0x0000013EA754BB38> instance must be a type, but 'notedown.NotedownContentsManager' could not be imported
对于该错误,其中提到了contents_manager_class,所以可能和notedown在该环境下未下载有关,经过pip install notedown,成功解决
