极空间docker部署markdown编辑器doocs+github图床教程

极空间docker部署markdown编辑器doocs+github图床教程!自动即时渲染微信图文,写文排版不再愁

引言

关注我的朋友都知道我这段时间在使用markdown编辑器,前面还因为使用不熟练,闹了个笑话,发出的文章啥格式都没有了。不过笑话归笑话,但是使用了好几款markdown编辑器后,还是选了个我认为最好用的markdown编辑器:doocs/md,一款高度简洁的微信 Markdown 编辑器,今天就给大家分享一下安装过程和图床配置过程。

什么是doocs/md

简单来说,这就是一个开源的Markdown文档编辑器,可以将markdown文档自动即时渲染为微信图文,让你不再为微信内容排版而发愁!只要你会基本的 Markdown 语法(现在有了 AI,你甚至不需要会 Markdown),就能做出一篇样式简洁而又美观大方的微信图文。

1
2
项目地址:https://github.com/doocs/md
项目体验地址:https://md.doocs.org/

核心优势

  • 完整 Markdown 支持 支持所有基础语法、数学公式
  • 图表渲染 - 支持 Mermaid 图表和 GFM 警告块
  • PlantUML 支持 - 强大的 UML 图表渲染
  • 代码高亮 - 丰富的代码块高亮主题,提升代码可读性
  • 自定义样式 - 允许自定义主题色和 CSS 样式,灵活定制展示效果
  • 草稿保存 - 内置本地内容管理功能,支持草稿自动保存
  • 多图床支持 - 提供多种图床选择,便捷的图片上传功能
  • 文件管理 - 便捷的文件导入、导出功能,提升工作效率
  • AI 集成 - 集成主流 AI 模型(DeepSeekOpenAI通义千问腾讯混元火山方舟302.AI 等),智能辅助内容创作图片

安装环境

本次部署是在极空间Q4上面完成的,这机器带了N95处理器,配置了16g内存,完全满足日常使用需要。

compose 部署

创建数据保存目录

安装之前需先在docker文件夹中新建一个“doocs”文件夹,用于配置持久化保存,后面所有相关文件都存在这里。图片

编写compose文件

打开极空间dockercompose新增项目项目名称(填doocs,可识别即可),将下面代码复制粘贴到代码框:

1
2
3
4
5
6
7
8
services:
# markdown 服务(缩写 md)
md:
container_name: markdown # 容器名称
image: doocs/md:latest # 镜像地址
ports:
- "8844:80" # 端口映射:宿主机8040 -> 容器80
restart: unless-stopped # 重启策略:除非手动停止,否则始终重启

不需要修改挂载路径。

图片

创建并启动镜像

  • 创建等待镜像拉取完成–显示容器运行中图片
  • 打开浏览器,输入nasip:8844,访问容器。

图片图片

部署成功!

部署图床

申请token

doocs支持12种图床服务,基本涵盖了主流。图片

咱们今天要配置的是github图床,可以看到需要的就三个参数,github仓库分支token图片

1.先输入https://github.com/进入github主页并登录你的账号密码,没有的话注册一个,无法打开网页属于网络问题,需要科学。

图片2.登录后点击右上角头像设置开发人员设置

图片3.进开发人员设置后,点击左边personal access tokens 旁边的三角形–点击tokens(classic),在右边“New personal access token”页面进行如下设置:

图片

  • Note:给这个Token起个名字,方便自己识别,如 doocs tuchuang
  • Expiration:设置有效期,建议选择“No expiration”(永不过期)或较长时间。
  • Select scopes:这是最重要的一步!必须勾选 repo,它会自动包含所有子权限。

4.拉到页面底部,点击“Generate token”按钮。

图片

5.立即复制并保存生成的Token! 这个Token只会显示一次,离开页面后将无法再次查看。图片

创建并初始化GitHub仓库

我们需要创建一个仓库来作为我们存放图片的地方。

1.在上面github页面右上角,点击右上角的“+”号,选择”New repository“。

图片2.进行仓库设置图片

  • Repository name:给仓库起个名字,例如 doocs
  • Public/Private:必须选择 Public(公开),否则图片无法被外部访问。
  • 点击“Create repository”。

3.这样仓库就创建成功了

图片4.初始化仓库 新创建的空仓库无法直接使用,否则可能会报错。我们必须在里面创建一个文件来完成初始化。最简单的方法是创建一个README.md文件。

图片

图片

  • 文件名默认为README.md,无需修改。直接点击右上角的“Commit changes...”,在弹窗中再次点击“Commit changes”。
  • ````
  1. 初始化完成。请注意,此时仓库的主分支名称是 main。

图片出现这个界面说明仓库初始化完成了。

配置doocs 容器

1.进入docker容器界面,编辑上传图片–本地上传中选择github

图片2.配置图床:

图片

  • 仓库地址:就是初始化完成后的那个地址。

  • 分支:就是我们看到的main

  • token:粘贴在github生成的token

  • 3.填好后点击保存配置,就设置好了。图片4.切换上传图床。 上传图片–本地上传–选择上传–图床选择github–开启图片压缩。然后就可以上传图片了。图片

试试传个图片

把图片拖到配置好后的框里,就可以看到进度条了,说明正在上传。图片上传完后,可以看到图片变成了一个github仓库的链接,同时右边预览画面出现图片,说明上传成功。

图片