jupyter notebook直接打开.md格式的文件

jupyter notebook是一个比较比较不错的网页版python编辑器,但是,由于很多“技术文档”都是直接以markdown(.md格式的文件)的格式编写的,而且jupyter notebook的代码文件(.ipynb)也可以转换成.md格式的文件,更为重要的是,我们从github上下载的很多学习资料也都是.md文件格式的。因此,为了能够在jupyter notebook上实现:

  1. 使用jupyter notebook浏览技术文档;
  2. 将转换成.md格式的python代码在不用转换格式的情况下直接由jupyter notebook上打开并且运行代码;
  3. 更加方便的由jupyter notebookgithub下载的资料。

我们需要在jupyter notebook中加入能够阅读.md文件的功能。

安装流程:

  1. anaconda的下载与安装;
  2. 如果在windows环境下需要配置一下anaconda的环境变量,即将anaconda安装目录的bin目录在环境变量中进行设置;
  3. 现在,你就可以使用anaconda的命令conda,使用命令conda create -n torch python=3.6;(其中的torch是你所设置的环境名称,以后你可以将自己工作所需要的python库在该环境下下载,它可以根据自己的需求修改;python=3.6 是对该环境下所需的python版本的配置,可以根据需求修改)
  4. 命令conda activate torch,激活刚才创建的环境,相当于进入到该环境下,如果要退出该环境,可以使用conda deactivate;(但是,我在windows环境下使用时,不需要加前面的conda,自己可以试一试)
  5. 进入刚才创建的环境后,jupyter notebook命令打不开相应的编辑器,因此我们需要安装它,安装命令conda install jupyter notebook;
  6. 安装成功后,使用命令jupyter notebook,就会弹出一个网页,并且将该目录的内容在在网页端编辑器中显示出来;(如图所示,是我打开的一个jupyter notebook编辑器,对于每一个文件,都能打开并且进行编辑)
  7. 但是,当我们打开一个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,成功解决

posted @ 2020-03-19 20:51  Lewen  阅读(4642)  评论(0编辑  收藏  举报