# AI_TEACH

**Repository Path**: fossilxiang_55192131/ai_teach

## Basic Information

- **Project Name**: AI_TEACH
- **Description**: 这是一个分享人工智能与机器学习教案的仓库
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 0
- **Created**: 2025-08-24
- **Last Updated**: 2025-11-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Markdown 转 DOCX 转换工具

这是一个用于将 Markdown 文件转换为 DOCX 格式的 Python 工具。它能够处理包含数学公式的文档，并确保转换过程的稳定性。

## 功能特点

- 自动检测并处理 Markdown 文件中的数学公式。
- 支持预处理 Markdown 文件，修复 YAML frontmatter 中的问题。
- 使用 Pandoc 进行文档转换，支持 emoji 和数学公式渲染。
- 能够处理包含大量数学公式的文件，如机器学习、数学推导等文档。

## 使用方法

1. 确保系统中已安装 [Pandoc](https://pandoc.org/)。
2. 将需要转换的 Markdown 文件放置在与脚本相同的目录中。
3. 运行脚本：

```bash
python convert_md_to_docx_robust.py
```

脚本会自动创建一个名为 `Docx` 的目录，并将所有转换后的 DOCX 文件保存其中，保持原有的文件结构。

## 注意事项

- 该工具对包含数学公式的文件进行了特别处理，确保公式能够正确显示。
- 如果遇到编码问题，脚本会尝试使用不同的编码格式进行读取和转换。
- 脚本会自动清理转换过程中生成的临时文件。

## 依赖项

- Python 3.x
- Pandoc
- `re`, `os`, `subprocess`, `tempfile`, `shutil` 等标准库模块

## 许可证

本项目采用 MIT 许可证。详情请查看项目中的 LICENSE 文件。

## 贡献者

欢迎提交 Pull Request 或报告 Issue。请确保代码风格与现有代码保持一致。