CodeMark 结合了 Code 与 Markdown 的特点，目标是让用户可以在浏览器中更轻量地编写、运行、管理和分享代码。
它尤其适合教学、作业、课堂演示和代码片段分享：学生不需要一开始就配置完整本地环境，也可以先在线运行 Python 代码，观察输出结果，再逐步迁移到本地开发。
如果你热衷于开源，或者想一起加入这个富有意义的项目，可以与我联系。
诚邀 Python、Web!!! 精通的伙伴～
CodeMark 不是为了替代专业 IDE，而是为了降低编程学习和代码分享的起步门槛。
- 对学生：减少环境安装带来的挫败感，先把注意力放在代码逻辑和运行结果上。
- 对老师：可以更方便地布置、展示、分享和讲解代码片段。
- 对内容创作者：可以把代码、说明、运行效果和分享链接组织到一个更易传播的页面中。
- 对自学者：可以快速验证想法，保存代码片段，并通过链接继续交流。
- 在线代码编辑：在浏览器中直接编写代码。
- Python 运行：通过 Pyodide 支持浏览器端 Python 运行体验。
- 代码分享：生成可访问的分享链接和二维码。
- 项目文件侧边栏：支持多文件、文件夹、上传、下载、重命名、删除和选择操作。
- 资源预览：支持图片等资源文件的导入与预览。
- 纯分享模式：可以只分享代码项目，不启用运行功能。
- 移动端适配：在移动设备上保留基础编辑、分享和文件管理入口。
CodeMark 侧边栏左上角使用 OK 作为轻量级工作区入口标识，表达“项目已就绪，可以开始编写、管理和分享代码”的状态感。
O：代表代码项目、文件集合与学习闭环，寓意用户可以在一个完整的工作区中组织代码。K：代表 Code、Keyboard 与 Knowledge，强调编写代码、动手实践和知识沉淀。OK：整体传达“可用、确认、准备就绪”的含义，让用户进入编辑器时能快速理解当前工作区处于可操作状态。
这个 Logo 在页面中不是复杂的品牌主视觉，而是一个清晰的功能入口：点击它，可以展开或折叠项目文件侧边栏，帮助用户管理多个文件、文件夹和代码资源。
- 教学文档：老师可以把代码示例和说明结合起来，便于课堂演示。
- 作业文档：学生可以在线完成代码题目，并通过链接提交或交流。
- 高校课程：适合用于编程作业布置、代码片段分享和课堂互动。
- 代码演示：适合快速展示一个 Python 示例、算法片段或实验思路。
- 学习记录：适合保存多个文件组成的小型代码项目。
/editor：可运行的 Python 在线编辑器，适合边写边运行。/sharecode：纯代码分享与多文件项目展示页面，适合不需要运行的代码分享。/share/<project_id>：分享链接页面，根据分享类型进入运行模式或纯分享模式。/admin/share-files/：管理员后台分享文件列表，可查看已存在的全部分享数据。
主要 Python 依赖可查看 requirements.txt，其中包含 Django、Markdown、Pillow、qrcode 等运行所需组件。
需要 Python 3.12+。当前 Django 版本为 6.0.x，官方支持 Python 3.12、3.13、3.14。
建议使用虚拟环境运行项目：
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python app.py如果使用 Django 命令运行：
python manage.py runserver 0.0.0.0:8991数据库与后台初始化：
python manage.py migrate
python manage.py create_admin_account --username admin当前项目默认使用 SQLite。首次执行 python manage.py migrate 时，Django 会自动在项目根目录创建 db.sqlite3 并初始化所需数据表。
创建管理员账号时可以直接传入账号信息：
python manage.py create_admin_account \
--username admin \
--email admin@example.com \
--password '替换为强密码'也可以通过环境变量设置账号信息：
CODEMARK_ADMIN_USERNAME=admin
CODEMARK_ADMIN_EMAIL=admin@example.com
CODEMARK_ADMIN_PASSWORD='替换为强密码'
python manage.py create_admin_account重置管理员密码：
python manage.py create_admin_account \
--username admin \
--password '新的强密码' \
--reset-password注册验证码邮件默认输出到控制台，适合本地调试。需要真实发送邮件时，在项目根目录创建 .env 并配置 SMTP：
DJANGO_EMAIL_BACKEND=django.core.mail.backends.smtp.EmailBackend
DJANGO_EMAIL_HOST=smtp.exmail.qq.com
DJANGO_EMAIL_PORT=465
DJANGO_EMAIL_USE_SSL=1
DJANGO_EMAIL_USE_TLS=0
DJANGO_EMAIL_HOST_USER=your-email@example.com
DJANGO_EMAIL_HOST_PASSWORD=your-smtp-password
DJANGO_DEFAULT_FROM_EMAIL="CodeMark <your-email@example.com>"DJANGO_EMAIL_HOST_PASSWORD 应使用邮箱服务商提供的客户端专用密码或授权码，不要提交到 Git。
常用迁移命令：
python manage.py makemigrations
python manage.py migrate
python manage.py showmigrations
python manage.py makemigrations --check --dry-run完整部署、宝塔部署、更新和排障流程请查看：
快速部署顺序：
cd /www/wwwroot/codemark-ok
python3.12 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
pip install gunicorn
cp .env.example .env.prod
# 编辑 .env.prod，至少设置：
# DJANGO_SETTINGS_MODULE=codemark_project.settings.prod
# DJANGO_SECRET_KEY=生产随机密钥
# DJANGO_DEBUG=0
# DJANGO_ALLOWED_HOSTS=你的域名,127.0.0.1,localhost
./scripts/init_deploy.sh .env.prod
set -a
source .env.prod
set +a
python manage.py create_admin_account生产环境需要通过 Gunicorn、systemd 或面板 Python 项目管理器运行，并使用 Nginx 反向代理。启动进程必须加载 .env.prod，否则可能会使用开发配置。C++ 交互运行会话保存在单个 Django 进程内，启用该功能时建议使用 --workers 1 --threads 8 或等效的单进程多线程配置。media/sharecode/ 和 db.sqlite3 是运行时数据，更新前请备份。
导出依赖：
pip freeze > requirements.txt服务端部署脚本请根据实际服务器路径调整，避免直接复用本地或旧服务器的绝对路径。
本项目全权由 AI悦创维护。如果想要拿去当作毕业设计、课设等，请及时联系与我沟通，严禁商用。
CodeMark is licensed under the GNU General Public License (GPL) Version 3. See the LICENSE file for more details.
CodeMark 是由 黄家宝|Bornforthis 创建并维护的开源项目。使用本项目即表示你同意 GNU General Public License (GPL) Version 3 的相关条款。
任何基于 CodeMark 的修改或衍生项目，也应遵循 GNU GPL 的开源协议要求。
欢迎提交功能改进、问题修复、文档优化和使用反馈。参与贡献即表示你的贡献内容将遵循与原项目相同的开源协议。