Skip to content

A complete Typora theme and Pandoc export workflow designed for mathematical modeling competition papers (MCM/ICM, CUMCM). Write in Markdown, export to a competition-ready Word document. 一套完整的数学建模竞赛(美赛/国赛)Typora 主题与 Pandoc 导出工作流。让你专注于 Markdown 写作,一键导出符合竞赛格式要求的 Word 论文。

License

Notifications You must be signed in to change notification settings

excniesNIED/typora-math-modeling-template-theme

Repository files navigation

Math Modeling Paper Templates for Typora

Typora Pandoc Contest License

(English Version Summary Below)

一份专为数学建模竞赛设计的 Typora 主题与论文排版工作流集合

本仓库旨在将内容创作格式排版彻底分离,让你无论是参加国赛 (CUMCM) 还是美赛 (MCM/ICM),都能使用 Markdown 高效写作,并通过一条命令导出符合相应竞赛格式的 Word 文档。


✨ 功能特性

  • 双主题支持:内置 cumcm-paper.css (国赛) 和 mcm-paper.css (美赛) 两个独立主题,提供精准的实时预览。
  • 格式标准化:严格遵循两大竞赛对标题、正文、字体、图表的官方格式要求。
  • 一键导出:基于 Pandoc 和定制化的 Word 参考模板,一键将 .md 文件转换为格式规范的 .docx 文档。
  • 内容与格式分离:彻底告别在 Word 中反复调整格式的痛苦,让你更专注于模型和求解。
  • 跨平台:无论你使用 Windows, macOS, 还是 Linux,都可以使用本工作流。

📁 仓库文件说明

  • 主题文件 (Themes):
    • cumcm-paper.css: 国赛 (CUMCM) 专用 Typora 主题。
    • mcm-paper.css: 美赛 (MCM/ICM) 专用 Typora 主题。
    • cumcm-ai-statement.css: 国赛 AI 工具使用详情说明文档专用主题,基于 vlook-solaris 修改的白色背景版本。
  • 参考模板 (Reference Docs):
    • reference-cumcm.docx: 国赛 Word 导出样式模板。
    • reference-mcm.docx: 美赛 Word 导出样式模板。
  • README.md: 本说明文档。

🚀 通用工作流程

无论参加国赛还是美赛,基本流程是相同的。

第 1 步:环境配置

  1. 安装 Typora: 从 Typora 官网 下载并安装。
  2. 安装 Pandoc: 强烈建议从 Pandoc 官网 下载并安装,这是实现一键导出的核心工具。

第 2 步:配置 Typora 主题

  1. 打开 Typora,进入 文件 -> 偏好设置 -> 外观 -> 打开主题文件夹
  2. 将本仓库中的 cumcm-paper.cssmcm-paper.csscumcm-ai-statement.css 三个文件都复制进去。
  3. 完全关闭并重启 Typora
  4. 重启后,从菜单栏的 主题 中根据你的需要选择:
    • CUMCM Paper: 国赛论文写作
    • MCM Paper: 美赛论文写作
    • CUMCM AI Statement: 国赛 AI 工具使用详情说明文档专用

第 3 步:撰写论文

在选定的主题下,使用 Markdown 撰写论文。请务必参考下方不同竞赛的《格式规范与写作约定》,以确保 Markdown 标签(如#, ##)能被正确渲染和导出。

第 4 步:一键导出为 Word 文档

这是最关键的一步。确保你的论文 .md 文件与相应的 .docx 参考模板放在同一个文件夹下。

导出美赛 (MCM/ICM) 格式 🇺🇸

打开命令行终端,进入文件所在目录,执行:

pandoc your-paper.md -o final-mcm.docx --reference-doc=mcmicm_template.docx

导出国赛 (CUMCM) 格式 🇨🇳

打开命令行终端,进入文件所在目录,执行:

pandoc your-paper.md -o final-cumcm.docx --reference-doc=cumcm_template.docx

Typora 导出方法请查看 Typora_Pandoc_Config.md

第 5 步:最终手动调整

导出后的 Word 文档已完成 95% 的工作。你只需进行少量最终调整:

  • 国赛: 按要求添加承诺书、编号页,并从摘要页开始设置页码。
  • 美赛: 添加官方要求的 Summary Sheet 和目录,并根据要求设置页码。

🎨 CUMCM AI Statement 主题说明

主题特性

cumcm-ai-statement.css 是专为 国赛参赛队编写 AI 工具使用详情说明文档 而设计的主题,基于知名的 vlook-solaris 主题进行修改,具有以下特点:

  • 🤖 专用场景: 专门针对国赛 (CUMCM) 参赛队在竞赛期间编写 AI 工具使用详情说明文档
  • 🔍 基于 vlook-solaris: 继承了 vlook 主题的优秀设计理念和布局结构
  • ⚪ 纯白背景: 移除了原主题的深色背景,改为经典的白色背景,便于打印和提交
  • ⚫ 黑色字体: 采用标准黑色字体,确保最佳的阅读体验和文档清晰度
  • 📝 学术字体: 参考 cumum-paper.css 的字体配置,使用 Times New Roman + 中文宋体的学术写作标准组合
  • 📄 文档规范: 符合竞赛组委会对说明文档的格式要求,简洁清晰

字体配置

  • 西文/数字: Times New Roman (学术标准)
  • 中文正文: 宋体 (SimSun/Songti SC)
  • 标题: 黑体 (SimHei/Heiti SC)
  • 字号: 小四 (12pt) 正文,四号 (14pt) 标题

与其他主题的区别

主题 背景色 字体颜色 设计风格 适用场景
cumcm-paper.css 白色 黑色 国赛标准格式 CUMCM 竞赛论文
mcm-paper.css 白色 黑色 美赛标准格式 MCM/ICM 竞赛论文
cumcm-ai-statement.css 白色 黑色 vlook 风格 + 学术字体 国赛 AI 工具使用说明文档

📑 格式规范与写作约定

🇺🇸 美赛 (MCM/ICM) 格式规范

项目 格式要求
摘要标题 Abstract: Arial, 小三 (15pt), 粗体, 居中
关键词 Key words: Arial, 四号 (14pt), 粗体
一级标题 Times New Roman, 小二 (18pt), 粗体
二级标题 Times New Roman, 三号 (16pt), 粗体
三级标题 Times New Roman, 四号 (14pt), 粗体
正文 Times New Roman, 12pt, 1.5倍或2倍行距
页码 页面底部中间或右侧

美赛写作约定 (重要!)

  • 摘要标题 Abstract: 使用 一级标题 (# Abstract)
  • 一级标题 (如 1. Introduction): 使用 二级标题 (## 1. Introduction)
  • 二级标题 (如 1.1 Assumptions): 使用 三级标题 (### 1.1 Assumptions)
  • 三级标题 (如 1.1.1 Data): 使用 四级标题 (#### 1.1.1 Data)
  • 关键词 Key words: 使用 五级标题 (##### Key words:)

🇨🇳 国赛 (CUMCM) 格式规范

项目 格式要求
论文题目 黑体, 四号, 居中
一级标题 摘要/问题重述等: 黑体, 四号, 居中
二级标题 2.1 模型假设: 黑体, 小四, 左对齐
正文 (中文) 宋体, 小四 (12pt)
正文 (西文/数字) Times New Roman, 小四 (12pt)
段落 首行缩进2字符, 多倍行距 1.25
页码 从摘要页开始, 页脚中部, 阿拉伯数字 "1"

国赛写作约定 (重要!)

  • 论文题目: 使用 一级标题 (# 你的论文题目)
  • 一级标题 (如 摘要, 问题重述): 使用 二级标题 (## 摘要)
  • 二级标题 (如 2.1 模型假设): 使用 三级标题 (### 2.1 模型假设)
  • 三级及以下标题: 使用 #### 等即可。

🤝 贡献与反馈

如果你发现任何问题或有改进建议,欢迎提交 Issue 或 Pull Request!

📄 许可证

本项目采用 MIT License 开源。


English Version Summary

This repository provides an all-in-one toolkit for academic writing in major mathematical modeling competitions. It includes:

  • Two distinct Typora themes: mcm-paper.css for the US Contest (MCM/ICM) and cumcm-paper.css for the China Contest (CUMCM).
  • Two corresponding Word reference templates: reference-mcm.docx and reference-cumcm.docx for high-quality export.
  • A unified workflow:
    1. Install Typora and Pandoc.
    2. Copy the CSS files to Typora's theme folder and select the one you need.
    3. Write your paper in Markdown, following the conventions detailed above for your specific contest.
    4. Use the appropriate Pandoc command to export your .md file to a beautifully formatted .docx document.
    5. Perform minor manual adjustments in Word (e.g., adding cover pages and setting page numbers).

This toolkit separates content from formatting, allowing you to focus on what truly matters: your model and your solution.

About

A complete Typora theme and Pandoc export workflow designed for mathematical modeling competition papers (MCM/ICM, CUMCM). Write in Markdown, export to a competition-ready Word document. 一套完整的数学建模竞赛(美赛/国赛)Typora 主题与 Pandoc 导出工作流。让你专注于 Markdown 写作,一键导出符合竞赛格式要求的 Word 论文。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages