md2star.gui module
md2star — minimal single-page GUI (“conversion bench”) served by the API.
This module holds nothing but the self-contained HTML document served by the
FastAPI app at GET /gui (see md2star.api). It is deliberately
build-step-free: one string of HTML + Tailwind (via CDN) + vanilla ES-module
JavaScript. There is no bundler, no framework, no npm — the whole page is a
static asset the API returns verbatim.
Two GUIs, on purpose
md2star ships two browser front-ends for two different jobs:
This bench (GET /gui on
md2star-api) — a tiny drop-a-file, pick-a-format, download-the-result page. It aligns md2star with the rest of the AI Helpers suite (audio_helper.gui/vocal_helper…), where every package’s FastAPI app serves a minimal/gui. It adds zero server logic: it POSTs to the same/convertendpoint the CLI and MCP surfaces reach.The editor (md2star gui,
md2star.gui_server) — the rich, Overleaf-style Markdown editor with a live PDF preview, folder browser, template upload and draft autosave. That is the primary human surface and is unaffected by this file.
Why a separate module
Keeping the (long) HTML out of md2star.api keeps the route definitions
readable and lets the rest of the suite copy this file almost verbatim: swap
the format list and the per-format form fields, keep the plumbing.
What the page does
Drop / pick a local Markdown file (kept entirely client-side until Run).
Choose a target format (docx / pptx / pdf) and optional metadata (author / language).
POST a
multipart/form-datarequest to the SAME/convertendpoint the CLI and MCP surfaces use — the GUI adds zero new server logic.Offer a download link for the rendered document.