# FiletoMD

**Repository Path**: nmgmpx/fileto-md

## Basic Information

- **Project Name**: FiletoMD
- **Description**: 调用Markitdown把文件转换为md格式
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-19
- **Last Updated**: 2026-05-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FileToMd

将文件批量转换为 Markdown，基于 Microsoft [MarkItDown](https://github.com/microsoft/markitdown)，支持 Windows 右键菜单集成。

## 支持的格式

纯文本、HTML、Word（`.docx`）、Excel（`.xlsx`/`.xls`）、PowerPoint（`.pptx`）、PDF、Jupyter（`.ipynb`）

## 安装

```bash
pip install markitdown
```

## 命令行用法

```bash
# 单文件：输出到文件所在目录
python file_to_md.py -f <文件路径>

# 目录：输出到 <源目录>_md（保留子目录结构）
python file_to_md.py <源目录>

# 目录：输出到指定目录（保留子目录结构）
python file_to_md.py <源目录> <目标目录>

# 目录：在源文件所在目录生成 .md（原地转换）
python file_to_md.py <源目录> --in-place
```

## 一键安装

```powershell
powershell -ExecutionPolicy Bypass -File install.ps1
```

脚本会自动：
1. 检查 Python 和 markitdown 环境
2. 将文件复制到 `%LOCALAPPDATA%\FileToMd\`
3. 注册 Windows 右键菜单

安装后在资源管理器中：
- 右键文件 → **Convert to Markdown** → 同目录生成 `.md`
- 右键目录 → **Convert to Markdown** → 原地转换所有文件

卸载：

```powershell
powershell -ExecutionPolicy Bypass -File install.ps1 -Uninstall
```

同时移除注册表和安装目录。

## 输出示例

```markdown
[[原文件名.pptx]]

（MarkItDown 转换后的 Markdown 内容）
```

首行 `[[]]` 为 Obsidian 双向链接，指向原始文件。