code-office

English | 简体中文 | 한국어

code-office is an independent VS Code extension for opening, reviewing, and editing document-heavy workspaces: Korean HWP/HWPX, Markdown notes, Office files, PDFs, archives, images, HTTP request files, registry files, and HTML.

• Project homepage: https://lidge-jun.github.io/code-office/
• Repository: https://github.com/lidge-jun/code-office
• Latest VSIX: https://github.com/lidge-jun/code-office/releases/latest

The main product split from upstream office viewers is editable HWP/HWPX with a bundled local rhwp-studio runtime. Common .hwp and .hwpx files can be opened, edited, and saved without Hancom Office, LibreOffice, or a remote service as the default path.

AI tools now create more drafts, citations, meeting notes, and source documents than teams can comfortably inspect in isolated viewers. This extension does not claim AI generation. It provides the VS Code document surface for that review loop: generated DOCX reports beside Markdown notes, Korean HWP/HWPX references beside source files, and provenance-sensitive formats kept in one workspace.

This project is not affiliated with or endorsed by Obsidian, Hancom, Microsoft, cweijan/vscode-office, rjwang1982/vscode-office, or rhwp.

What Makes It Different

• HWP/HWPX editor: full rhwp toolbar, text editing, table/cell selection, local WASM runtime, VS Code native save lifecycle.
• Format-aware save: HWP files write HWP bytes, HWPX files write HWPX zip/XML packages, and mismatched output is rejected before disk writes.
• Office and workspace previews: Word, Excel, PDF, PowerPoint, images, fonts, archives, HTTP request files, registry files, and HTML.
• Markdown workspace: Vditor-based Markdown editing with inherited export paths for PDF, DOCX, and HTML.
• Independent brand surface: repository metadata, GitHub Pages, package icon, README, and notices now point at this project while preserving required MIT lineage.

Product Screenshots

The screenshots below come from local smoke samples built for this repository. Office/PDF/HWP captures were taken in VS Code Insiders after installing the packaged VSIX. The HTML capture is the same local review sample rendered directly for a clean visual check. Temporary samples are generated outside the repo so tracked vendor documents are not modified.

Local HWP/HWPX editing Bundled rhwp-studio runtime, full toolbar surface, and VS Code save lifecycle.	DOCX and source-context review Generated briefs and source notes stay together instead of moving through disconnected viewers.
XLSX review dashboard Spreadsheet gates, owners, scores, and publish readiness are inspectable inside the workspace.	PDF evidence map Source packets and provenance maps stay beside drafts and Korean office references.
PPTX text/media preview Narrative decks are available for lightweight inspection while deeper fidelity work remains on the roadmap.	HTML export review Web drafts can be checked as part of the same AI-era document review flow.

Install

Install the latest release VSIX from GitHub Releases:

code --install-extension ./code-office-<version>.vsix

For VS Code Insiders:

code-insiders --install-extension ./code-office-<version>.vsix --force

After installation, open a supported file and choose code-office when VS Code asks for an editor. HWP/HWPX files are registered through the inherited cweijan.hwpEditor custom editor ID for compatibility with existing VS Code custom editor associations.

Supported Formats

HWP/HWPX Editing

HWP support is powered by a pinned local build of edwardkim/rhwp, vendored as vendor/rhwp-studio-dist and copied into resource/rhwp-studio during build.

The VS Code integration uses a dedicated editable CustomEditorProvider:

HWP/HWPX file
  -> HwpEditorProvider
  -> React HWP view
  -> local rhwp-studio bridge
  -> rhwp WASM document engine
  -> exportHwp/exportHwpx
  -> VS Code saveCustomDocument

What works today:

• Open .hwp and .hwpx files with the full rhwp editor toolbar.
• Edit text and use rhwp table/cell selection features.
• Save with Cmd+S / Ctrl+S or the toolbar button.
• Preserve the destination format: .hwp writes HWP bytes, .hwpx writes HWPX bytes.
• Use the bundled local runtime by default without network access.

Known limits:

• rhwp is not Hancom Office. Very complex HWP/HWPX documents may still have layout or round-trip differences.
• Bundled open fonts are used as fallbacks. Proprietary Hancom or Microsoft fonts are not bundled.
• Optional code-office.hwp.studioUrl is an advanced trusted remote runtime override; the default remains local.

Settings

Some vscode-office.*, office.*, and cweijan.* identifiers intentionally remain for compatibility with existing settings, commands, and custom editor associations. Runtime ID migration is tracked as a separate compatibility task. Previous vscode-obsdian.hwp.* values are read as a legacy fallback, but new documentation and package settings use code-office.hwp.*.

Release Checks

For local release verification:

npm run release:local

The release gate runs type checks, builds the WebView and extension host, verifies HWP hardening assumptions, packages the VSIX, and checks that the VSIX contains the bundled rhwp runtime while excluding samples, vendor sources, docs, and development scripts. npm run smoke is an alias for the same full gate.

Manual smoke before publishing:

1. Install the generated VSIX in VS Code or VS Code Insiders.
2. Open a .hwp file, edit text, save, close, and reopen.
3. Open a .hwpx file, edit text, select table cells, save, close, and reopen.
4. Open Markdown, HTML, XLSX, DOCX, PDF, PPTX, image, and archive samples.
5. Confirm no stale HWP loading banner or false Save As prompt remains.

Marketplace publish is intentionally gated:

npm run publish

This first runs npm run release:local, then invokes vsce publish --no-dependencies.

GitHub Pages

The product page is deployed from docs/ through .github/workflows/pages.yml. It is a public marketing and documentation surface only; the extension does not use GitHub Pages at runtime by default.

The package icon source is images/logo-new.svg, rendered to images/logo-new.png, and copied to docs/assets/logo-new.png for the Pages site. The logo was created for this repository from an OpenAI image generation concept and manually simplified into SVG; it is not derived from upstream vscode-office artwork or any third-party app logo.

Roadmap

• Obsidian-style [[wikilink]] completion, navigation, and WebView/export integration.
• PPTX preview stabilization beyond text/media extraction.
• Markdown CJK inline formatting and strikethrough polish.
• Excel strikethrough/style preservation.
• Optional LibreOffice fallback completion for complex legacy presentations.
• Continued HWP/HWPX hardening and fixture-based smoke tests.

See structure/roadmap.md for the internal phase record.

Attribution

code-office contains code derived from MIT-licensed vscode-office work:

• cweijan/vscode-office, original project by Weijan Chen
• rjwang1982/vscode-office, a maintained fork by RJ.Wang

HWP/HWPX editing uses a local build of edwardkim/rhwp. Bundled fonts and document runtime components remain subject to their own licenses.

Full notices are in NOTICE.md. The original MIT license text is preserved in LICENSE.