Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ An interactive reference for ECMA-376 (Office Open XML) built by the [SuperDoc](

## Why This Exists

The official ECMA-376 spec is 5,000+ pages. Most of it you'll never need, and the parts you do need often omit critical rendering details that only surface when you compare against Word's actual behavior. This site fills that gap with implementation notes from building SuperDoc — a document engine that renders OOXML natively in the browser.
The official ECMA-376 spec is 5,000+ pages. Most of it you'll never need, and the parts you do need often omit critical rendering details that only surface when you compare against Word's actual behavior. This site fills that gap with implementation notes from building SuperDoc, the open source DOCX Editor and Agent SDK for reviewing, filling, and editing documents.

This is also how people discover SuperDoc. By sharing what we've learned, we position ourselves as the OOXML experts. Every page should reflect that authority: practical, specific, from-experience.

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,4 +124,4 @@ MIT

---

Built by 🦋 [SuperDoc — DOCX editing and tooling](https://superdoc.dev)
Built by 🦋 [SuperDoc — DOCX Editor and Agent SDK](https://superdoc.dev)
4 changes: 2 additions & 2 deletions apps/web/public/llms.txt
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

> For full documentation content, see [/llms-full.txt](https://ooxml.dev/llms-full.txt)

ooxml.dev is the interactive reference for ECMA-376 (Office Open XML) — the standard behind .docx, .xlsx, and .pptx files. Built by SuperDoc — DOCX editing and tooling (https://superdoc.dev) from experience implementing a full OOXML document engine.
ooxml.dev is the interactive reference for ECMA-376 (Office Open XML) — the standard behind .docx, .xlsx, and .pptx files. Built by SuperDoc — DOCX Editor and Agent SDK (https://superdoc.dev) from experience implementing a full OOXML document engine.

Every page combines XML structure, live rendered previews, and implementation notes that tell you what the spec doesn't: where Word diverges from the standard, what will break your code, and what to do about it.

Expand Down Expand Up @@ -52,4 +52,4 @@ Package metadata (curated from ECMA-376 Part 1 §11.3.x / §12.3.x / §13.3.x /

## About

ooxml.dev is built by SuperDoc — DOCX editing and tooling (https://superdoc.dev). SuperDoc is a document engine that renders OOXML natively in the browser. The implementation notes on ooxml.dev come from building that engine against thousands of real-world documents.
ooxml.dev is built by SuperDoc (https://superdoc.dev). SuperDoc is the open source DOCX Editor and Agent SDK for reviewing, filling, and editing documents. Word-quality DOCX editing, built for your product. The implementation notes on ooxml.dev come from building that engine against thousands of real-world documents.
4 changes: 2 additions & 2 deletions apps/web/scripts/prerender.ts
Original file line number Diff line number Diff line change
Expand Up @@ -222,7 +222,7 @@ function buildHead(path: string): string {
dateModified: new Date().toISOString().split("T")[0],
author: {
"@type": "Organization",
name: "SuperDoc — DOCX editing and tooling",
name: "SuperDoc",
url: "https://superdoc.dev",
},
publisher: { "@type": "Organization", name: "ooxml.dev", url: "https://ooxml.dev" },
Expand Down Expand Up @@ -256,7 +256,7 @@ function buildHead(path: string): string {
url,
author: {
"@type": "Organization",
name: "SuperDoc — DOCX editing and tooling",
name: "SuperDoc",
url: "https://superdoc.dev",
},
publisher: { "@type": "Organization", name: "ooxml.dev", url: "https://ooxml.dev" },
Expand Down
2 changes: 1 addition & 1 deletion apps/web/src/components/Footer.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ export function Footer() {
href="https://superdoc.dev/?utm_source=ooxml.dev&utm_medium=referral&utm_campaign=footer"
className="text-[var(--color-accent)] hover:underline"
>
SuperDoc — DOCX editing and tooling
SuperDoc — DOCX Editor and Agent SDK
</a>
</footer>
);
Expand Down
4 changes: 2 additions & 2 deletions apps/web/src/data/docs.ts
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ export const docs: Record<string, DocPage> = {
{ type: "heading", level: 2, text: "What's Different Here" },
{
type: "paragraph",
text: "The official spec is 5,000+ pages and omits critical rendering details. This reference fills the gap: live previews, implementation notes from building [SuperDoc — DOCX editing and tooling](https://superdoc.dev/?utm_source=ooxml.dev&utm_medium=referral&utm_campaign=docs), and links to 1M+ real documents from [docx-corpus](https://docxcorp.us). Every note comes from shipping code, not reading the spec.",
text: "The official spec is 5,000+ pages and omits critical rendering details. This reference fills the gap: live previews, implementation notes from building [SuperDoc — DOCX Editor and Agent SDK](https://superdoc.dev/?utm_source=ooxml.dev&utm_medium=referral&utm_campaign=docs), and links to 1M+ real documents from [docx-corpus](https://docxcorp.us). Every note comes from shipping code, not reading the spec.",
},
{ type: "heading", level: 2, text: "OOXML Structure" },
{
Expand Down Expand Up @@ -764,7 +764,7 @@ w:rPr (run properties)
content: [
{
type: "paragraph",
text: "Lessons learned from building [SuperDoc — DOCX editing and tooling](https://superdoc.dev/?utm_source=ooxml.dev&utm_medium=referral&utm_campaign=docs).",
text: "Lessons learned from building [SuperDoc — DOCX Editor and Agent SDK](https://superdoc.dev/?utm_source=ooxml.dev&utm_medium=referral&utm_campaign=docs).",
},
{ type: "heading", level: 2, text: "Word-Specific Issues" },
{
Expand Down
2 changes: 1 addition & 1 deletion apps/web/src/pages/Mcp.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -379,7 +379,7 @@ export function Mcp() {
rel="noopener noreferrer"
className="text-[var(--color-accent)] underline decoration-[var(--color-accent)]/30 hover:decoration-[var(--color-accent)]"
>
SuperDoc — DOCX editing and tooling
SuperDoc — DOCX Editor and Agent SDK
</a>
</span>
<Link
Expand Down
10 changes: 5 additions & 5 deletions brand.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,9 +12,9 @@ parent: SuperDoc

### Overview

ooxml.dev is the interactive reference for ECMA-376 (Office Open XML) — built by the team behind SuperDoc — DOCX editing and tooling, a document engine that renders OOXML natively in the browser.
ooxml.dev is the interactive reference for ECMA-376 (Office Open XML) — built by the team behind SuperDoc, the open source DOCX Editor and Agent SDK for reviewing, filling, and editing documents.

It exists because the SuperDoc — DOCX editing and tooling team needed better OOXML documentation and it didn't exist. The official spec is 5,000+ pages of PDFs that omit critical rendering details. Word's actual behavior diverges from the spec in ways you only discover by building against it. So we wrote down everything we learned — the structure, the gotchas, the places where the spec lies — and made it public.
It exists because the SuperDoc team needed better OOXML documentation and it didn't exist. The official spec is 5,000+ pages of PDFs that omit critical rendering details. Word's actual behavior diverges from the spec in ways you only discover by building against it. So we wrote down everything we learned — the structure, the gotchas, the places where the spec lies — and made it public.

What ooxml.dev really does is translate implementation experience into usable knowledge. Every page combines XML structure, live rendered previews (powered by SuperDoc), and implementation notes that tell you what the spec doesn't: where Word disagrees with the standard, what will break your implementation, and what to do about it.

Expand All @@ -33,7 +33,7 @@ The problem it solves is information asymmetry. The knowledge required to implem
**What ooxml.dev is NOT**:
- Not the spec itself — we explain the spec, we don't replace it
- Not an SDK or library — we teach the format, not an API
- Not a document editor or viewer — SuperDoc — DOCX editing and tooling is the product, this is the knowledge
- Not a document editor or viewer — SuperDoc is the product, this is the knowledge
- Not a consulting service — the knowledge is free and public
- Not academic documentation — every insight comes from shipping real code

Expand Down Expand Up @@ -113,7 +113,7 @@ ooxml.dev saves you the weeks of trial-and-error we already went through.

### Identity

We build document infrastructure at SuperDoc — DOCX editing and tooling, and we learned OOXML the hard way — by implementing it against thousands of real documents and watching things break in ways the spec never warned us about.
We build SuperDoc, the DOCX Editor and Agent SDK, and we learned OOXML the hard way — by implementing it against thousands of real documents and watching things break in ways the spec never warned us about.

ooxml.dev is where we write down everything we learned. Not because we have to. Because the alternative — leaving every developer to independently discover that `w:tblGrid` crashes Word when omitted, or that style inheritance doesn't work the way the schema implies — is a waste of everyone's time. The knowledge exists. It should be accessible.

Expand All @@ -135,7 +135,7 @@ _Use on homepage hero, social bios, link previews._
- Developer discovery: "5,000 pages of spec. The 200 that matter. The notes you actually need."
- AI/MCP context: "Ask the spec anything, query the schema directly, or look up any OPC part type. One server."
- Community pitch: "Hard-won OOXML knowledge, shared freely."
- SuperDoc connection: "Built by SuperDoc — DOCX editing and tooling. Open to everyone."
- SuperDoc connection: "Built by SuperDoc — DOCX Editor and Agent SDK. Open to everyone."
- Credibility: "Every example is a working document."

### Message Pillars
Expand Down
Loading