先上效果图

在线预览-python版本 powered by kingreatwill/mdserve.
在线预览-golang版本 powered by kingreatwill/mdserver.

markdown项目:https://github.com/kingreatwill/open

目的

经常写笔记时在vs code中进行,里面插件很丰富,对markdown以及扩展支持的都很好,但是离开vs code后,里面有很多扩展功能支持的不是很好,使用过gitbook,甚至还专门为其写的一些扩展。也使用过jekyll以及github pages,但是里面或多或少会出现一些问题,所以决定自己做一个。

开始撸

选型

代码

代码放出来就太啰嗦了,直接这里:https://github.com/kingreatwill/mdserve

发布

在setup.py文件中修改版本

python setup.py sdist bdist_wheel
twine upload dist/mdserve-1.0.0*

功能

  • 左侧目录icon,这里使用是vscode-icons中的svg资源
  • 默认首页index.html,index.md,README.md.注意大小写,linux是区分大小写的. 参数--index
  • 指定markdown目录,参数--directory
  • 指定host和port,参数--host以及--port
  • 如果是git仓库还可以定时pull,参数--crontab

使用

pip install --upgrade mdserve
mdserve
# 带参数
# mdserve --directory /path/md --port 8080

docker,由于我没有上传到docker hub,所这里使用dockerfile
dockerfile

FROM python:3.8-slim
RUN sed -i "s@http://deb.debian.org@https://mirrors.163.com@g" /etc/apt/sources.list
RUN apt-get update && apt-get install git -y
RUN pip install --upgrade mdserve -i https://pypi.org/simple/
RUN mkdir -p /usr/share/mdserve
WORKDIR /usr/share/mdserve
EXPOSE 8080 8080
CMD ["mdserve"]

打包运行

docker build --no-cache -t mdserve:1.4 -f ./dockerfile .
docker stop mdserve
docker rm mdserve
docker run -itd -p 8001:8080 -v /root/github/open:/usr/share/mdserve --name mdserve mdserve:1.4

demo

katex

综合演示

posted on 2021-11-05 22:43  kingreatwill  阅读(543)  评论(1编辑  收藏  举报