Converter documentos Office para HTML
Todo handle do Office Oxide tem o método to_html(), que produz HTML5 semântico e limpo a partir de qualquer formato suportado. Use para preview no navegador, renderização de e-mails ou comparação visual rápida.
Conversão direta
Rust
use office_oxide::to_html;
let html = to_html("report.docx")?;
std::fs::write("report.html", html)?;
Python
import office_oxide
html = office_oxide.to_html("report.docx")
open("report.html", "w").write(html)
JavaScript
import { toHtml } from 'office-oxide';
import { writeFileSync } from 'node:fs';
writeFileSync('report.html', toHtml('report.docx'));
Go
html, err := officeoxide.ToHTML("report.docx")
os.WriteFile("report.html", []byte(html), 0o644)
C#
File.WriteAllText("report.html", OfficeOxide.ToHtml("report.docx"));
C
int err = 0;
char *html = office_to_html("report.docx", &err); /* HTML fragment */
if (html) {
FILE *f = fopen("report.html", "w");
fputs(html, f);
fclose(f);
office_oxide_free_string(html);
}
Handle reutilizável
Rust
let doc = office_oxide::Document::open("slides.pptx")?;
let html = doc.to_html();
Python
from office_oxide import Document
with Document.open("slides.pptx") as doc:
html = doc.to_html()
JavaScript
using doc = Document.open('slides.pptx');
const html = doc.toHtml();
C
int err = 0;
OfficeDocumentHandle *doc = office_document_open("slides.pptx", &err);
char *html = office_document_to_html(doc, &err); /* HTML fragment */
if (html) { /* use html */ office_oxide_free_string(html); }
office_document_free(doc);
WASM
import { WasmDocument } from 'office-oxide-wasm';
const data = new Uint8Array(await (await fetch('/slides.pptx')).arrayBuffer());
using doc = new WasmDocument(data, 'pptx');
const html = doc.toHtml(); // HTML fragment
O que é gerado
O HTML é em estilo fragmento — sem invólucros <html>, <head> ou <body>. Você decide onde montar e qual stylesheet aplicar.
| Origem | Elemento HTML |
|---|---|
| Título | <h1> … <h6> no nível correspondente |
| Parágrafo | <p> |
| Negrito / itálico / sublinhado | <strong>, <em>, <u> |
| Lista | <ul> / <ol> com filhos <li> |
| Tabela | <table> com <thead>, <tbody>, <tr>, <th>, <td> |
| Hyperlink | <a href="..."> |
| Imagem | <img src="..." alt="..."> |
| Planilha XLSX | <section data-sheet="name"> + <table> |
| Slide PPTX | <section data-slide="N"> + corpo + <aside> opcional para notas |
A saída vem escapada: o conteúdo do usuário dentro do documento é HTML-escapado, então embutir o resultado em uma página é seguro por padrão.
Embrulhar como página standalone
Python
from office_oxide import Document
with Document.open("report.docx") as doc:
body = doc.to_html()
page = f"""<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>Report</title>
<link rel="stylesheet" href="docs.css">
</head><body>{body}</body></html>"""
open("report.html", "w").write(page)
Casos de uso
- Preview no navegador de documentos enviados pelo usuário (
<input type="file">→ WASM →<iframe srcdoc>) - Renderização de e-mails para relatórios gerados
- Visualização de diffs — diffs em HTML rendem de forma significativa em ferramentas de code review
- Indexação para busca mantendo a estrutura (títulos podem impulsionar resultados)
Veja também
- Extração Markdown — quando você quer saída mais amigável para texto puro
- Extração IR — JSON estruturado para renderizar do seu jeito
- Início rápido WASM — para conversão dentro do navegador