知识与效率

微信 Markdown 编辑器:排版与自托管

  • 0 次阅读
  • 0 条评论
文章摘要

doocs/md 用 Markdown 编写文章并生成适合公众号的富文本样式,支持预览与复制。适合保持标题、列表和代码风格统一,复制后仍应在目标编辑器中检查实际效果。 Markdown 原稿保存内容结构,主题决定富文本样式,预览用于检查公众号效果。目标编辑器可能重新处理部分样式。 适合统一技术文章排版。先设置稳定的标题、代码与图片风格,再复制到草稿。

项目介绍

doocs/md 用 Markdown 编写文章并生成适合公众号的富文本样式,支持预览与复制。适合保持标题、列表和代码风格统一,复制后仍应在目标编辑器中检查实际效果。

Markdown 原稿保存内容结构,主题决定富文本样式,预览用于检查公众号效果。目标编辑器可能重新处理部分样式。

适合统一技术文章排版。先设置稳定的标题、代码与图片风格,再复制到草稿。

核心功能

功能 作用与使用方式
实时预览 边写边检查
主题样式 统一正文和标题
代码排版 设置高亮与布局
图片链接 检查插图展示
富文本复制 送入公众号草稿

功能示意

微信 Markdown 编辑器 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

微信 Markdown 编辑器 官方界面示例
项目官方界面示例,展示上游演示数据。

项目信息

项目 说明
类型 Docker
分类 知识与效率
项目仓库 doocs/md
官方入口或文档 直接访问
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 可以先使用官方在线版测试,再决定是否自行部署。NAS 方案按下面配置启动,打开 http://NAS_IP:3080。
  2. 输入一段包含标题、表格、代码块与图片的测试文章,选择主题和代码样式,确认预览符合预期。
  3. 复制渲染结果到公众号测试草稿,检查图片、链接、换行和移动端显示。排版满意后保存 Markdown 原稿,避免只保留富文本副本。

首次使用与操作检查

用含表格、长代码和图片的短稿测试,复制后在公众号手机预览核对。

保存 Markdown 原稿,不只保留富文本。链接和图片在目标平台重新检查,长代码避免手机横向溢出。

Docker Compose

依据官方 README 的 doocs/md 镜像和 80 容器端口整理,宿主端口设为 3080。文章原稿通过编辑器导出备份。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/doocs-md/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/doocs-md
cd /volume1/docker/doocs-md
HALO_PREPARE
cd /volume1/docker/doocs-md
services:
  md:
    image: doocs/md:latest
    restart: unless-stopped
    ports:
      - "3080:80"

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 编辑器能正确预览,不表示公众号允许所有 HTML 样式;以目标草稿实际显示为准。
  • 浏览器本地内容可能受缓存清理影响,重要文章随时导出。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

文章 Markdown、图片与自定义样式单独备份,保留目标平台的最终草稿版本。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料