如何在Linux下使用Markdown进行文档工作

在Linux系统中，编辑markdown可以用retext工具：

sudo apt-get install retext

retext Release-Notes.md

要将markdown文件转换成html文件，可以用discount

sudo apt-get install discount

转换工作很简单：

markdown -o Release-Notes.html Release-Notes.md

我们也可以在文档目录下放置这样一个Makefile来自动这个过程

MD = markdown

MDFLAGS = -T

H2PFLAGS = --html

SOURCES := $(wildcard *.md)

OBJECTS := $(patsubst %.md, %.html, $(wildcard *.md))

build: html

html: $(OBJECTS)

$(OBJECTS): %.html: %.md

$(MD) $(MDFLAGS) -o $@ $

现代化的写作工具不是要好安装，而是应该可以不安装，随时可用，打开就写字。——全时在线的网页版编辑器才行！

现代化的写作工具不仅要能编写，而是应该还可以发布，可以随时分享给其他人阅读。——你需要的不仅是编辑器，还要是建站工具！

随时随地，打开就写作，换电脑也无所谓，手机上都能行！

不需要任何繁琐的设置或额外的工具，一个命令就能发布到自己的博客网站，让全世界都可以看到！

真有这么神奇的工具？

请保持一点耐心，跟我一起，花20分钟彻底解决你的Markdown写作工具的烦恼！

结果注定是诱人的，但还是要提前告诉你所需的一切，如果你害怕挑战或者过于吝啬金钱，那么你可以在这里就考虑止步。

我们以阿里云为例，使用支付宝注册登录后，直接进入他们的【开发者成长计划】优惠页面。

https://developer.aliyun.com/plan/grow-up

在这里往往有最优惠的服务器ECS产品，年费不到100元。推荐购买2核2G或者更高配置。

购买时候请注意下面几点，其他都默认设置。

购买成功后从右上角进入【控制台】，找到你的【ECS服务器实例】，点进去，找到【配置安全组规则】点进去，点【配置规则】，这里列出了所有已经开放的端口，点击右上角【添加安全组规则】，d窗选协议类型【自定义TCP】，端口范围【8888】，授权对象【0.0.0.0/0】，确认添加上去，看起来如下图所示。

还是在控制台的【ECS服务器实例】页面，点【远程连接】，d出窗口选【Workbench远程连接】的【立即登录】。在d出的黑色窗口中用户名和密码都已经自动填写好了，直接确认即可进入命令行模式。

依次执行下面的每行命令并回车确认。

sudo yum install epel-release

sudo yum install nginx

sudo systemctl start nginx

sudo systemctl enable nginx

这里安装的nginx就是网站服务程序，安装成功后它会把 /usr/share/nginx/html/ 文件夹下的所有文件都发布成网页，记住这个地址，后面会用到。

这时你可以直接把实例的IP地址复制到浏览器中回车查看，已经可以打开默认页面了。

继续在远程连接后的命令行页面，依次执行下面的每行命令并回车确认。

sudo yum instlal bzip2

wget https://repo.anaconda.com/archive/Anaconda3-2020.11-Linux-x86_64.sh

bash Anaconda3-2020.11-Linux-x86_64.sh

source ~/.bashrc

conda --version

第二个命令可能需要几分钟，耐心等。

最后应该输出conda 4.9.2就表示安装成功了。

继续执行下面命令。

jupyter notebook --generate-config

sed -i "s/# c.NotebookApp.allow_origin = ''/c.NotebookApp.allow_origin = '*'/" /root/jupyter_notebook_config.py

sed -i "s/# c.NotebookApp.allow_root = False/c.NotebookApp.allow_root = True/" /root/.jupyter/jupyter_notebook_config.py

sed -i "s/# c.NotebookApp.open_browser = True/c.NotebookApp.open_browser = True/" /root/.jupyter/jupyter_notebook_config.py

sed -i "s/# c.NotebookApp.notebook_dir = ''/c.NotebookApp.notebook_dir = '\/usr\/share\/nginx\/html\/'/" /root/.jupyter/jupyter_notebook_config.py

继续执行下面的命令来启动编辑器。

nohup jupyter notebook &

然后将你的云服务器IP地址复制到浏览器中，并添加 :8888 就能打开登录页面，比如 112.26.78.51:8888 。

首次登录可以设置密码，以后都要用这个密码。登录进去之后如下图所示，这是所有发布页面的文件夹，我们后续所有编写的文件都放在这里。

如果这个密码丢失或者总是设置失败，可以回到远程连接的命令窗口，输入 jupyter notebook password 然后根据提示设置新密码。

在上图文件夹页面的右上角【新建】按钮可以新建文件夹，然后勾选文件夹可以进行【重命名】，如下图所示。

如何撰写文章？

同样在【新建】创建一个【Python3】文件，打开后如下图所示。

这里的每个单元都是微型编辑器，点击上面下拉菜单选择Markdown，然后就可以撰写文章。

工具栏的加号【+】可以增加新的单元格，上下箭头可以移动单元格。

单元格编写状态下（鼠标在格子内闪烁），按ESC键退出，或者直接点击单元格左侧 In[] 使其光标消失，然后按快捷键【M】即可切换为Markdown。这个 *** 作也可以用shift按键点选单元格左侧，选中多个单元格一起切换成Markdown模式。

同样光标消失状态下，可以使用快捷键A或B快速添加单元格，A在当前单元格之上添加，B在下面添加。

删除单元格的快捷键是按两次D，慎用。删除后需要从【编辑】菜单才能撤回。

撰写完成单元格后按【Shift+回车】进入预览状态，再次双击文字内容进入编辑状态。

直接点击左上角的【Untiled】标题字样可以快速修改文件名，也可以从这里复制文件名。如下图所示。

保存当前的文章。

文章底部新建一个Code模式的单元格，粘贴下面的命令可以把当前的Python3文件转化成网页文件，注意这里的 笔记 一定要和上面的文件名完全一致。

!jupyter nbconvert --to html 笔记.ipynb --template classic

这个 *** 作将在当前文件夹下生成一个 笔记.html 网页文件，可以使用类似 112.26.78.51:8888/foldername/笔记.html 在浏览器内打开。

如何制作首页？

可以直接在最外层文件夹下新建一个Python3文件，然后重命名为 index ，再把它当做Markdown来进行编辑。要知道Markdown文件内是可以直接粘贴截图，也可以粘贴链接的，所以我们只要把其他的文章链接添加到 index 的单元格内就可以了。

可以参照我的Notebook博客的样式进行编辑，地址是 http://notebook.10knet.com/ 。

编辑好内容后，再用Code单元格执行下面的命令生成首页并发布。

!jupyter nbconvert --to html index.ipynb

虽然 *** 作起来比较繁琐，但这绝对是一劳永逸的好办法。

后续我会想办法把这个流程做的更简单，或者制作一个镜像模板给大家直接使用。

拥有属于自己的网站博客，随时随地舒爽的撰写Markdown文章，不受限制的发表自己的想法，希望你也能体会到我现在的感受，——这篇文章就是这样产生的。

END

---