构建自己的md编辑环境docker

20210514 -

0. 引言

之前为了记录自己的实验过程，或者一些简单的工作记录，都是在CSDN的草稿箱中，来进行记录，好处就是能够使用MD语法， 图片贴起来也比较方便。
但是在写久了之后就发现了一些毛病，最让我非常难受的地方，就是这个序号的问题，标题的编号问题，每次弄这个编号，如果有中间的编号变了，那么就得把所有的编号都弄上。另外，这个东西本质上也没有版本控制的过程，我没有办法看到，我之前的历史版本，这就比较尴尬了。如果没删什么东西还好，一旦删了什么重要的东西，就完蛋。

那么简单说一下我的需求：

• 能够自动对标题进行编号
• 图片能够直接拖拽
• 能够支持git

想到了这些之后，我就想到了之前的时候，部署过jupyterlab的容器，加上我使用jupyter notebook的时候也发现，能够通过md语法设置标题，而且还支持git，同时测试了一下图片的拖拽，也是可行的，正好满足我的需求。

1.0 部署镜像

1.1 镜像选取

在jupyter的官网[1]的介绍中，有多个镜像可以选择：

• jupyter/base-notebook
• jupyter/minimal-notebook
• jupyter/scipy-notebook
  等等，因为本身只是想要一个编辑器（当然后续的时候，也可以将实验的过程都转移到这个部分来，暂时不需要），所以考虑到占用的空间和实际的需要，选择了jupyter/minimal-notebook，一方面这个镜像包含了jupyter所需的东西，同时添加了git的支持。

在docker hub上选取相应的镜像，在tag上虽然有些不同，但是摘要都是一样的，执行命令：

docker pull jupyter/minimal-notebook:lab-3.0.14

1.2 启动镜像

根据其官网的介绍，按照下面的参数部署：

docker run  -d -p 12306:8888 \
    -v /xxxx:/home/jovyan/work \
    --name my_md_working \
    -e JUPYTER_ENABLE_LAB=yes \
    -e RESTARTABLE=yes \                                                                                                                                                     
    jupyter/minimal-notebook:lab-3.0.14 \
    start-notebook.sh 

其中-v是为了将文件保存到本地，按照需求来进行选择；端口这里采用12306作为宿主机的映射端口。

2.0 环境简单配置

打开http://xxxx:12306，输入docker启动之后的token，就可以进入jupyter lab的界面，

2.1 设置默认cell格式

默认cell是代码的形式，每次都修改太麻烦，根据问答[3]，在高级配置中，配置下面命令：

{
    "defaultCell": "markdown"
}

2.2 拖拽图片

问答[4]中提供了图片在MD的展示方法，现在已经支持了拖拽的方式，而且在chrom中还支持粘贴复制。

2.3 安装GIT扩展

在扩展中，搜索git，然后按照他的提示安装即可，可能过程比较慢。在提示安装差不多的时候，就重启一下jupyter，注意前面docker的命令中已经设置了jupyter为循环，所以不用重启docker容器。

2.4 带颜色的markdown

通过插入html语句来实现带颜色的字体：

<span style="color:blue">some *blue* text</span>.

参考

[1]Selecting an Image
[2]Common Features
[3]Jupyter notebook new cell type default
[4]Inserting image into IPython notebook markdown
[5]How to apply color in Markdown?