leakypixel/mdrender

镜像概述

leakypixel/mdrender是一个基于Node的Docker镜像，用于运行Markdown渲染脚本，包含基础的文件监视任务。该镜像从容器内固定路径/app/mdrender/content读取Markdown源文件，渲染后将结果输出到/app/mdrender/output目录。请注意，此镜像目前处于Alpha阶段，功能和稳定性可能存在较多限制。

核心功能与特性

• Markdown渲染：内置脚本可将Markdown文件转换为目标格式（具体输出格式未明确说明，基于通用Markdown渲染逻辑）
• 文件监视任务：包含简单的文件变化监视功能，可检测/app/mdrender/content目录中文件的修改并触发重新渲染
• 固定目录映射：采用固定的输入输出路径设计，需通过卷挂载方式指定本地源文件和输出目录

使用场景与适用范围

适用于对Markdown文件进行自动渲染的轻量场景，例如：

• 个人本地文档的实时转换与预览
• 简单静态站点的Markdown内容自动化生成
• 开发环境中对Markdown文件的快速渲染测试

不建议场景：生产环境、对渲染稳定性/格式完整性有高要求的业务场景（因处于Alpha阶段）

使用方法与配置说明

docker-compose配置示例

推荐通过docker-compose进行部署，示例配置如下：

yaml
mdrender:
  image: leakypixel/mdrender
  restart: unless-stopped  # 容器退出时除非手动停止，否则自动重启
  volumes:
    # 本地Markdown源文件目录，需只读挂载到容器输入目录
    - "/path/to/your/markdown/files:/app/mdrender/content:ro"
    # 本地渲染结果输出目录，需读写挂载到容器输出目录
    - "/path/to/your/output/dir:/app/mdrender/output:rw"
    # 可选：同步容器与宿主机时区（避免时间相关问题）
    - "/etc/localtime:/etc/localtime:ro"

卷挂载说明

docker run命令示例

若需直接通过docker run启动，命令格式如下：

bash
docker run -d \
  --name mdrender \
  --restart unless-stopped \
  -v /path/to/your/markdown/files:/app/mdrender/content:ro \
  -v /path/to/your/output/dir:/app/mdrender/output:rw \
  -v /etc/localtime:/etc/localtime:ro \
  leakypixel/mdrender

注意事项

• Alpha阶段限制：镜像处于早期开发阶段，可能存在功能不完善、渲染错误或监视任务失效等问题
• 目录权限：确保本地挂载目录具有正确权限，避免因权限不足导致容器无法读取源文件或写入输出结果
• 监视功能局限：内置监视任务为"dumb watch task"（简单实现），可能无法处理复杂目录结构变化或高频文件修改场景