更新 README.md 和 app.py，新增功能與錯誤處理，改善使用者體驗

README.md

@@ -1,12 +1,34 @@
----
 title: Hg Markitdown
-emoji: 🚀
-colorFrom: purple
-colorTo: red
+emoji: �
+colorFrom: blue
+colorTo: green
 sdk: gradio
 sdk_version: 5.25.0
 app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# MarkItDown 檔案轉 Markdown 工具
+
+這個專案提供一個基於 Gradio 的網頁介面，支援拖放或選取檔案（PDF、Word、Excel、PowerPoint、圖片、音訊等）並自動轉換為 Markdown 內容，方便快速複製使用。
+
+## 功能特色
+
+- 支援拖曳或選擇檔案即時轉換
+- 轉換結果以 Markdown 元件呈現，支援語法高亮
+- 內建複製按鈕，可一鍵複製轉換後內容
+- 可手動按「開始轉換」重新觸發、更新結果
+
+## 執行方式
+
+```bash
+pip install -r requirements.txt
+python app.py
+```
+
+執行後於終端機顯示的網址（預設 http://127.0.0.1:7860/）即可打開網頁並進行檔案上傳轉換。
+
+## 注意事項
+
+- 請確認已安裝 `markitdown[all]` 所需的系統依賴與 NLP 模型。
+- 若遇到特定檔案格式無法解析，請檢查檔案是否完整、未加密，或參考 MarkItDown 官方文件取得額外支援。

app.py

@@ -1,26 +1,47 @@
 import gradio as gr
 from markitdown import MarkItDown
-import os
-import shutil
-from uuid import uuid4
 
 md = MarkItDown()
 
-def convert_file_to_md(file):
+def convert_file_to_md(file_path: str) -> str:
+    if not file_path:
+        return "⚠️ 未收到檔案，請重新上傳。"
+
     try:
-        result = md.convert(file.name)  
-        content = result.text_content
+        result = md.convert(file_path)
+        content = result.text_content or ""
     except Exception as e:
         content = f"❌ 轉換失敗：{str(e)}"
+
+    if not content.strip():
+        return "ℹ️ 轉換完成，但沒有可顯示的 Markdown 內容。"
+
     return content
 
-demo = gr.Interface(
-    fn=convert_file_to_md,
-    inputs=gr.File(label="上傳支援格式檔案（如 PDF、Word、Excel 等）"),
-    outputs=gr.Textbox(label="轉換後的 Markdown 結果", lines=25),
-    title="📄 MarkItDown 文件轉 Markdown 線上工具",
-    description="上傳你的檔案，我們將自動轉換為 Markdown 格式內容，支援 PDF、Word、Excel、PowerPoint、圖片、音訊等格式。",
-    allow_flagging="never"  # ← 加這行就不會出現 Flag 按鈕了
-)
 
-demo.launch()
+with gr.Blocks(title="📄 MarkItDown 文件轉 Markdown 線上工具") as demo:
+    gr.Markdown("""
+    ## 📄 MarkItDown 文件轉 Markdown
+    上傳支援格式檔案，系統會自動轉換為 Markdown 內容。也可以按下「開始轉換」手動觸發。
+    """)
+
+    with gr.Row():
+        file_input = gr.File(
+            label="拖曳或選擇支援格式檔案（PDF、Word、Excel、PowerPoint、圖片、音訊等）",
+            file_count="single",
+            type="filepath",
+        )
+        convert_button = gr.Button("開始轉換", variant="primary")
+
+    gr.Markdown("### 轉換後的 Markdown 結果")
+    output = gr.Markdown(
+        value="請上傳或轉換檔案，結果將顯示於此。",
+        show_copy_button=True,
+    )
+
+    file_input.upload(convert_file_to_md, inputs=file_input, outputs=output)
+    convert_button.click(convert_file_to_md, inputs=file_input, outputs=output)
+
+
+if __name__ == "__main__":
+    demo.launch()