Docx-to-Markdown
layout-aware Word to Markdown converter
Get picks like this daily. Today's launch numbers, the top launches, AI and tech news, and a daily opportunity pick, straight to your inbox.
Want to reach these readers? Sponsor an issue.
Hey HN, I’m the author of the https://github.com/eigenpal/docx-editor, it’s an SDK that implements Word-compatible layout engine in Typescript.Today, we are releasing Word to markdown converter library. It’s open source and published under Apache 2.0 license. It uses our layout engine, so it can return accurate, per-page markdown blocks (with headers, footers, and image references). We also handle fonts (Google fonts as fallback) or let you pass your font files upfront for accurate content measurement.To our surprise, Word to per-page Markdown conversion is not a solved problem even in 2026! We initially faced this friction when preprocessing Word documents for agentic workflows. For our use case, it was important to represent per-page content in markdown. Initially, we ended up using LibreOffice sidecar to convert to PDF and then using .pdf -> .md library. This was not ideal given that LibreOffice sidecar that was sitting idle most of the time.This issue is addressed with docx-to-markdown library. it can be used directly in your Typescript ingestion pipeline. Try with your docs at https://www.docx-editor.dev/solutions/word-to-markdown.(if you catch any bugs please let us know in the comments / or file gh issues)
HN · launched Sep 16, 2026 · 5 upvotes (top 87%) · 0 views
Niche: document and file conversion tools · 216 launches, 24 in the last 7 days ▼ -4% · Explore this niche →
Category and tags
- Horizontal
- Dev tools
- Developer
- Not AI
- Hobby / open-source project
Visit website ↗ Source listing ↗
More like this: all 216 launches in document and file conversion tools →
Could you build this?
No Building a layout-aware Word-to-Markdown converter requires writing a full Word-compatible layout and pagination engine in TypeScript, which entails deep reverse engineering of Microsoft Word's proprietary rendering, line-breaking, and pagination rules.
What it would actually take: The engine requires parsing OpenXML (DOCX), extracting font metrics, constructing a layout tree, computing exact line-breaks, margins, tables, headers/footers, and page breaks identical to Word's rendering engine. A real version requires implementing font measurement pipelines (Canvas/FreeType/HarfBuzz in WASM), handling bidirectional text and complex script layout, and managing complex table pagination algorithms. This level of specification compliance and rendering fidelity demands specialized document engineering expertise.
Discussion
5 comments analyzed.
Competitors mentioned: Microsoft Office, Google Workspace
Concerns raised: Docx to markdown is a lossy conversion losing formatting details
Feature requests: Convert markdown back to docx, Sync markdown edits back to docx
Competitors
Other products that read as similar to this one : 531 launches clear the similarity bar, closest 8 shown.
Attention rank: #502 of 532 (itself plus its competitors, highest first, normalized so YC and Product Hunt are compared fairly).
Launched 320 days after the earliest competitor.
- MarkAny · ph · 2026-09-11 · 2 upvotes · similarity 0.59
- MDFormats · ph · 2026-11-10 · 1 upvotes · similarity 0.59
- Word in Web · hn · 2026-07-21 · 37 upvotes · similarity 0.55
- Open-source .docx editor library for building document apps · hn · 2026-05-21 · 107 upvotes · similarity 0.54
- Docx to PDF in the Browser Using Pandoc and Typst (WASM) · hn · 2026-02-09 · 6 upvotes · similarity 0.54
- PDF To Markdown · ph · 2026-10-17 · 1 upvotes · similarity 0.54
- Md2docx · hn · 2026-11-04 · 5 upvotes · similarity 0.53
- PDF to Markdown that preserves layout, images, and tables · hn · 2026-01-02 · 6 upvotes · similarity 0.53
The niche, labels, vibe code rating and competitor comparison on this page are analysis by Nicheloom. If you use them, please credit nicheloom.com. How you may use our data.