How to Upload HTML to Gemini
Gemini does not reliably handle HTML through its standard upload. Convert to Markdown first, then paste or upload the Markdown — that is the path with the fewest dead ends.
Gemini is happy to accept an HTML upload — it is the downstream behavior where things get interesting. Gemini does not accept HTML files natively in the standard upload flow, so you have to convert first. This guide walks through the whole path: where to drop the file, what usually breaks, and when it is worth converting to Markdown before you upload. Web pages bring their furniture with them. Navigation, cookie notices and footers all convert just as faithfully as the article you actually wanted. Gemini takes uploads via Plus icon to attach a file, or import directly from Google Drive, caps individual files around 100MB, and works with roughly 1,000,000 tokens of context on its default variant. The short version: give Gemini clean structure — headings, lists, tables that survived the trip — rather than a raw HTML and the hope that the parser does the right thing.
Why convert to Markdown before uploading
The case for a Markdown intermediate step, specifically for HTML in Gemini.
- Markdown is token-efficient. You can fit substantially more of an HTML document inside Gemini's context window (currently around 1,000,000 tokens, give or take depending on the plan and model variant) once formatting overhead is gone.
- Gemini respects Markdown structure. Headings become navigable sections, lists stay as lists, and tables that survive conversion stay readable for the model.
- You get a predictable failure mode. When an HTML parser inside Gemini silently drops a page or column, you rarely notice until the answer is wrong. With Markdown, what you see is what the model sees.
- Batch and reuse get easier. A Markdown file drops cleanly into Custom GPTs, Claude Projects, NotebookLM notebooks, or a RAG pipeline without per-tool quirks.
- HTML uploads carry nav bars, cookie banners, and inline scripts that pollute the context. Markdown conversion strips the chrome and keeps the actual content.
Markdown keeps the document structured when it travels through the Workspace pipeline, so you are not relying on Gemini's auto-conversion guesses. Converted HTML files come through at around 98% text accuracy, with table fidelity we would call excellent. The usual catch with HTML: javaScript-rendered content requires pre-processing. Convert once and reuse the Markdown across Gemini chats rather than re-uploading the original every time.
Step-by-step: HTML into Gemini
- 1
Skip the direct HTML upload
Gemini does not reliably accept HTML in the standard flow. Do not waste time wrestling with it — go straight to a Markdown conversion.
- 2
Convert the HTML file to Markdown
Open markdownconverters.com/conversion/html, drop your HTML file in, and download the .md output. Strip navigation and cookie banners first if you can. Otherwise the boilerplate ends up in your Markdown and competes with the actual content.
- 3
Skim the Markdown before you upload
Open the output in any text editor. Check that the main article survived and that navigation lists did not end up as content. Thirty seconds here saves an hour of debugging answers that were never going to be right.
- 4
Upload to Gemini
In gemini.google.com, click the plus icon to attach, or pick it from Google Drive. If it is a Markdown file, Gemini will treat it as plain text rather than auto-converting to a Doc — which is what you want.
- 5
Prompt with structure in mind
Reference the file by name, then point at a section rather than asking broadly. That means quoting the heading: "In the 'Pricing' section, what is the tier for..." instead of "what does this say about pricing". Gemini retrieves noticeably better when you narrow it yourself.
- 6
Verify against the source
Ask Gemini to quote the passage it is citing. If the quote does not appear in the Markdown, you have either a retrieval miss or a hallucination — re-check the conversion or narrow the prompt.
Gotchas with HTML in Gemini
The specific failure modes we see most often — worth knowing before you spend an afternoon debugging "bad" model answers that are really upload problems.
- Office formats from outside Google Workspace sometimes get auto-converted to Docs/Sheets first, which can rearrange content
Office formats from outside Google Workspace sometimes get auto-converted to Docs/Sheets first, which can rearrange content
- EPUB is not natively supported
you need to convert first
- XLSX workbooks only expose the active sheet cleanly; hidden sheets or pivot tables often get dropped
XLSX workbooks only expose the active sheet cleanly; hidden sheets or pivot tables often get dropped
- When you upload through Drive, permission inheritance means a file you can see may not be readable by Gemini
When you upload through Drive, permission inheritance means a file you can see may not be readable by Gemini
Getting better answers from Gemini
- Upload through Plus icon to attach a file, or import directly from Google Drive — that is the path Google actually supports, and the one least likely to silently truncate your file.
- Gemini holds roughly 1,000,000 tokens, about 727k words. Converted HTML content is compact, but a long document plus a long conversation still competes for the same budget.
- Stay under about 10MB per file even though the hard cap is 100MB. Retrieval quality degrades well before the limit, particularly on dense HTML content.
- Office formats from outside Google Workspace sometimes get auto-converted to Docs/Sheets first, which can rearrange content.
- XLSX workbooks only expose the active sheet cleanly; hidden sheets or pivot tables often get dropped.
- Gemini reads Markdown structure well, so ask it to cite the heading it answered from. If it cannot name one, your content was not retrieved.
- Convert the article URL rather than a saved page where you can. Saved HTML tends to carry inlined scripts and styling that survive as noise in the Markdown.
Frequently asked questions
Can I upload an HTML file to Gemini directly?
Not reliably. Gemini either does not accept HTML at all or accepts it with heavy restrictions. The supported path is to convert to Markdown (or PDF, in a pinch) and upload that.
What is the file-size limit on Gemini?
As of this writing, Gemini typically caps individual uploads around 100MB, with a context window of roughly 1,000,000 tokens on the default variant. These numbers shift with releases and differ by plan, so verify in the app before relying on a specific figure. The practical limit is lower than the hard cap anyway — retrieval quality starts to degrade well before you hit it, especially for dense technical documents. Smaller, focused files beat one enormous one.
Does converting HTML to Markdown lose information?
Markdown drops visual formatting — fonts, colors, exact page layout — because it is a semantic format. It preserves headings, lists, tables, and text content, which is what LLMs actually use. For HTML specifically, the things that matter (Web scraping projects, Blog content migration) survive cleanly. Things like decorative styling do not, and usually should not.
How many HTML files can I upload to Gemini at once?
It varies by tier. The free version of Gemini is usually stingy with persistent uploads; paid tiers and Projects/Spaces are where bulk HTML workflows become practical.
Is this safe — what happens to my HTML file?
When you upload to Gemini, the content is processed by Google's infrastructure under their terms. If the document is sensitive, consider using the enterprise tier (where retention and training policies differ), or convert locally where possible. Markdown Converters does not retain your uploaded files beyond the conversion window.
Keep going
Drop HTML files in and download Markdown ready to upload to Gemini.
Check how much of your converted HTML will actually fit inside Gemini's context window.
Same workflow, tuned for ChatGPT's upload quirks and context window.
Same workflow, tuned for Claude's upload quirks and context window.
Working with PDF instead of HTML? The gotchas are different.
Background on why clean Markdown consistently outperforms native uploads across every major assistant.
Convert HTML for Gemini in one step
Clean Markdown output ready to drop into Gemini. Free tier, no account required to try.