# trae-md

**Repository Path**: alwarse/trae-md

## Basic Information

- **Project Name**: trae-md
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-12
- **Last Updated**: 2025-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Markdown文档处理工具集

这是一个用于处理和转换Markdown文档的工具集合，支持将Markdown文档标准化、转换为表格格式，并最终导出为Excel文件。

## 技术栈

- **Node.js**: 运行环境
- **xlsx**: Excel文件处理库
- **fs/promises**: 文件系统异步操作
- **path**: 路径处理工具

## 开发指导

### 环境配置

1. 确保已安装Node.js环境
2. 安装项目依赖：
   ```bash
   npm install
   ```

### 使用流程

项目提供了三种使用方式：

1. 一键转换（推荐）：
   ```bash
   node onestepmd2excel.js
   ```
   这将自动执行完整的转换流程。

2. 分步转换：
   ```bash
   # 步骤1：转换为标准MD格式
   node tostandardmd.js
   
   # 步骤2：转换为MD表格
   node trans2mdtable.js
   
   # 步骤3：转换为Excel
   node md2excel.js
   ```

## 目录结构

```
├── files/                # 源Markdown文件目录
├── standard-md-files/    # 标准化后的Markdown文件
├── output-table/         # 转换后的表格格式Markdown
│   └── Testfile/        # 测试用例文件
├── excel/               # 最终的Excel文件输出目录
├── tostandardmd.js      # Markdown标准化工具
├── trans2mdtable.js     # 转换为表格格式工具
├── md2excel.js          # 转换为Excel工具
└── onestepmd2excel.js   # 一键转换工具
```

## 功能介绍

### 1. Markdown标准化 (tostandardmd.js)

- 规范化Markdown文档格式
- 统一标题、列表、代码块等元素的格式
- 处理空行和缩进
- 输出到standard-md-files目录

### 2. 表格转换 (trans2mdtable.js)

- 将标准化的Markdown文档转换为表格格式
- 提取规则相关信息（编号、文本、等级等）
- 分离测试用例到单独文件
- 输出到output-table目录

### 3. Excel转换 (md2excel.js)

- 读取表格格式的Markdown文件
- 转换为Excel格式
- 保持表格结构和数据完整性
- 输出到excel目录

### 4. 一键转换 (onestepmd2excel.js)

- 集成上述三个工具的功能
- 自动按顺序执行转换流程
- 提供完整的转换日志
- 简化用户操作

## 注意事项

1. 确保源文件放置在files目录下
2. 源文件必须是.md格式
3. 转换过程会自动创建所需的输出目录
4. 建议使用一键转换工具以确保转换流程的完整性