mafgwo/stackedit

StackEdit中文版Docker镜像文档

镜像概述

StackEdit中文版是一款基于Web的在线Markdown编辑器Docker镜像，在原版基础上深度优化，专为中文用户打造。其核心功能是提供高效的Markdown编辑环境，并支持将笔记存储至GitHub、Gitee、Gitea等Git仓库，实现文档的版本化管理与多平台同步。

核心功能与特性

1. 多Git仓库支持

• 支持GitHub、Gitee、Gitea等主流Git仓库作为笔记存储后端
• 支持仓库级别的文档空间管理，可创建、编辑、删除仓库中的Markdown文件
• 部分版本支持关闭自动同步，自定义提交信息（需版本≥5.15.13）

2. 图床集成

• 支持多种图床粘贴/拖拽自动上传图片：
  • GitHub图床（版本≥5.15.9）
  • Gitea图床（版本≥5.15.8）
  • SM.MS图床（版本≥5.15.7）
  • 自定义图床（版本≥5.15.8）
• 支持图片存储到当前文档空间（版本≥5.15.15）

3. 主题与界面定制

• 编辑区域支持主题选择及自定义（版本≥5.15.14）
• 预览区域支持主题选择（版本≥5.15.17）
• 支持一键切换亮/暗主题（版本≥5.15.10）

4. 文档管理功能

• 历史版本管理：支持编辑记录回滚，防止内容丢失
• 左边栏文件搜索（版本≥5.15.11）
• 支持[TOC]目录生成（版本≥5.15.12）
• 支持MD文档相互链接跳转（版本≥5.15.16）

5. 扩展功能支持

• KaTeX数学表达式渲染
• Mermaid UML图绘制
• 乐谱等特殊格式渲染

使用场景与适用范围

• 个人笔记管理：适合个人日常Markdown笔记编写、存储与版本控制
• 技术文档创作：支持技术文档的结构化编写，结合Git仓库实现版本管理
• 团队协作：通过Git仓库实现多人协作编辑，适合小型团队文档协作
• 博客/内容创作：可直接编辑并推送至代码托管平台的Pages服务（如GitHub Pages、Gitee Pages）

使用方法与配置说明

Docker快速部署

使用以下命令快速启动StackEdit中文版容器：

bash
docker run -d \
  --name stackedit \
  -p 8080:8080 \
  -v stackedit_data:/root/.stackedit \
  --restart always \
  mafgwo/stackedit:latest

参数说明：

• -p 8080:8080：端口映射，将容器的8080端口映射到主机的8080端口
• -v stackedit_data:/root/.stackedit：数据卷挂载，持久化存储编辑器配置及缓存数据
• --restart always：容器异常退出时自动重启

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  stackedit:
    image: mafgwo/stackedit:latest
    container_name: stackedit
    ports:
      - "8080:8080"
    volumes:
      - stackedit_data:/root/.stackedit
    restart: always

volumes:
  stackedit_data:

启动服务：

bash
docker-compose up -d

访问与初始化

1. 容器启动后，通过http://主机IP:8080访问StackEdit中文版
2. 首次使用需进行基础配置，包括选择默认存储仓库（Gitee/GitHub/Gitea等）
3. 根据提示完成Git仓库授权，即可开始创建和编辑Markdown文档

版本说明

• 5.15.17：支持预览区域选择主题
• 5.15.16：支持MD文档相互链接跳转
• 5.15.15：支持图片存储到当前文档空间
• 5.15.14：支持编辑区域可选主题
• 5.15.13：支持文档空间关闭自动同步（针对Gitee、GitHub、Gitea、Gitlab），关闭后可自定义提交信息
• 5.15.12：支持[TOC]目录
• 5.15.11：支持左边栏搜索文件
• 5.15.10：支持一键切换亮/暗主题，样式优化
• 5.15.9：支持GitHub图床粘贴/拖拽自动上传图片
• 5.15.8：支持自定义图床与Gitea图床的粘贴/拖拽自动上传图片
• 5.15.7：支持SM.MS图床粘贴/拖拽自动上传图片
• 5.15.6：主文档空间从GoogleDrive改成了Gitee
• 5.15.5：完成汉化并修复Gitee与Gitea相关bug
• 5.15.3：支持Gitea
• 5.15.2：支持Gitee

开源地址

• Gitee开源地址：https://gitee.com/mafgwo/stackedit
• GitHub开源地址：https://github.com/mafgwo/stackedit

交流与支持

• ***703187410