# flomo2md

**Repository Path**: loongzzl/flomo2md

## Basic Information

- **Project Name**: flomo2md
- **Description**: 将flomo导出的html文件转成md文件。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-22
- **Last Updated**: 2026-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 🚀 Flomo 笔记转 Markdown 工具 (AI 增强版)

### 📝 简介 (Summary)

本工具旨在将 Flomo 的 HTML 导出文件（位于 ZIP 压缩包内）高效、准确地转换为 Obsidian 或其他 Markdown 笔记软件兼容的单文件 Markdown 格式。

**核心亮点**：

  * **多线程并发**：快速处理大量笔记。
  * **AI 智能处理**：利用 DeepSeek 或 OpenAI API，为每条笔记自动生成简洁的**标题**和**标签**，极大提升整理效率。
  * **跨平台 EXE**：通过 PyInstaller 打包，可在 Windows 上独立运行，无需安装 Python 环境。

-----

### ✨ 主要功能

  * **HTML 到 Markdown 的精确转换**：
      * 将 Flomo 的富文本内容转换为标准的 Markdown 格式。
      * **自动处理图片**：将笔记中的图片提取并统一复制到 `assets` 文件夹，在 Markdown 文件中生成正确的相对链接。
  * **结构化 YAML Front Matter**：
      * 自动在每个文件顶部生成 YAML 元数据，包含创建时间、AI 标签和 AI 标题（可选）。
  * **内部链接解析**：
      * 识别 Flomo 内部引用链接，并尝试将其转换为 Obsidian 等软件可识别的本地 Markdown 文件链接。
  * **日志与索引**：
      * 转换过程提供详细日志。
      * 生成 `index.csv` 索引文件，记录每条笔记的转换状态、AI 标题和标签。

-----

### ⚙️ 如何运行 (EXE)

如果您拥有 Windows 版本的打包文件 (`FlomoToMarkdown.exe`)，运行过程非常简单：

1.  **双击运行** `FlomoToMarkdown.exe`。
2.  在图形界面中：
      * 点击 **“浏览...”** 选择您从 Flomo 导出的 **ZIP 压缩包**。
      * (可选) 选择一个 **输出目录**，如果不选择，默认在 ZIP 文件所在的目录生成一个以 ZIP 文件名命名的文件夹。
3.  **API Key (如果启用 AI)**：
      * 勾选 **“启用 AI 智能标题和标签”**。
      * 在 **“API Key”** 栏输入您的 **DeepSeek** 或 **OpenAI API Key**。
      * *(注：程序不会保存您的 Key。)*
4.  点击 **“开始转换”**。等待日志窗口显示 `[DONE] 转换流程完成` 即可。

-----

### 💻 开发者/高级用户 (Python 运行)

#### 1\. 环境准备

需要 Python 3.8+ 环境。首先安装依赖库：

```bash
pip install openai beautifulsoup4
```

#### 2\. 文件结构

请确保您的核心逻辑文件 (`flomo_core.py`) 和图形界面文件 (`main_gui.py`) 位于同一目录。

#### 3\. 运行命令

```bash
python main_gui.py
```

### 📦 打包指南 (PyInstaller)

如果您修改了代码并想重新生成 Windows EXE 文件：

1.  确保已安装 `PyInstaller`：
    ```bash
    pip install pyinstaller
    ```
2.  在 `flomo_core.py` 和 `main_gui.py` 所在的目录下执行打包命令：
    ```bash
    pyinstaller --noconsole --onefile --name=FlomoToMarkdown main_gui.py
    ```
3.  生成的 EXE 文件位于 `dist` 文件夹内。