Skip to content

README.md

Latest commit

 

History

History
59 lines (45 loc) · 1.62 KB

README.md

File metadata and controls

59 lines (45 loc) · 1.62 KB

Markdown Translator

GitHub license

A localized translation tool based on Python + Flask + PyWebView, offering a native Mac app-like experience.

Screenshot

Features

  • MacOS Style UI: Dark frosted glass texture, immersive experience.
  • Markdown Editor: Integrated EasyMDE, supports split-pane real-time preview.
  • Extensible: Backend based on Flask, easily integrates with OpenAI / DeepL / Baidu Translate APIs.

Tech Stack

  • Backend: Python, Flask
  • GUI: PyWebView (WebKit)
  • Frontend: HTML5, CSS3, EasyMDE, Marked.js, KaTeX
  • Build Tool: PyInstaller

Development

  1. Clone the repository:

    git clone https://github.com/yujingyao-dev/MarkdownTranslator
cd MarkdownTranslator

  2. Install dependencies:

    pip install -r requirements.txt

  3. Add your personal Google genai api key at .env

  4. Run:

    python app.py

How to Build

Mac users can execute the following command to generate the .app file:

pyinstaller --name "MarkdownTranslator" \
            --windowed \
            --add-data "templates:templates" \
            --add-data "static:static" \
            --clean \
            --noconfirm \
            app.py

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgement

  • I thank my father and mother, who give birth to me.
  • I thank Nanyang Technological University, who provides with a chance to try.
  • I thank Google Gemini 3 Pro, who assists my programming.