Skip to content
zarnuqPublic

About

Obsidian Plugin that lets you open, read and edit Word and PowerPoint files right inside Obsidian.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Repository files navigation

Doc Works

Open and edit Word, PowerPoint and Excel files right inside Obsidian.

Downloads Release Latest Release License: GPL-3.0

Editing a slide deck with the menu bar, toolbar and slide thumbnails

  • Looks like PowerPoint, Word and Excel. Themes, layouts, shapes, SmartArt, tables, document styles and cell formats render faithfully, even without Office fonts.
  • Doesn't break your files. Only what you edit is rewritten; everything else is saved back byte-for-byte.
  • Self-contained. No Office, no LibreOffice, no system dependencies. Works offline.

If it saves you a trip to Office, please ⭐ the repo.

Editing a Word document in page view with the ruler

Editing a spreadsheet with conditional formatting, dropdowns and a chart

Features

Documents (.docx)

  • Word-accurate pages: real page sizes per section, Word's line heights and font widths, columns
  • Styles, fonts, lists, paragraph spacing, borders and shading
  • Tables with merged cells, borders, shading and header rows that break across pages
  • Pictures with wrapping and dragging; shapes, text boxes, charts and equations
  • Headers and footers per section, with pictures, page numbers and watermarks
  • Suggesting mode and tracked changes from Word (accept / reject)
  • Comments with replies and resolve / reopen
  • Footnotes, table of contents, links
  • Document outline and a ruler for margins, indents and tab stops
  • Fonts embedded in the file are used

Presentations (.pptx)

  • Faithful slides: themes, masters, layouts, backgrounds, SmartArt (edit its text; add and remove items in lists, processes, cycles, hierarchies and radial diagrams) and all 187 preset shapes
  • Fonts embedded in the deck are used, including Google Slides' exports
  • Text editing on the slide with bullets, numbering and autofit
  • Shapes, connectors, group / align / distribute with snapping
  • Tables with table styles, pictures with crop and colour adjustments, charts
  • Custom themes and layouts, slide size, sections, hidden slides
  • Transitions and object animations
  • Slideshow with presenter view and speaker notes
  • Comment threads, audio and video
  • Copy, cut and paste slides between decks, keeping their look

Spreadsheets (.xlsx)

  • Fast grid that stays smooth on sheets with 100,000+ cells
  • Formulas with about 120 functions, recalculated live across sheets
  • Google Sheets functions and Google exports (QUERY, ARRAYFORMULA, REGEX…)
  • Number formats, fonts, fills, borders, alignment, merges, frozen panes
  • Conditional formatting, icon sets, data bars, dropdowns and validation
  • Charts, pictures, sparklines and pivot tables with nested rows and columns and filters
  • Notes and threaded comments
  • Sort, filters, row / column groups, named ranges
  • Sheet protection with locked cells and passwords
  • Formulas it can't calculate keep the file's saved result

Everywhere

  • Saves only what you change; the rest of the file is kept byte for byte
  • Google Docs / Slides / Sheets-style menus and toolbars, or (beta, per file type in settings) desktop Word / PowerPoint / Excel-style ribbons with a customizable Quick Access Toolbar, a status bar, the apps' right-click menus with their mini toolbars, and their keyboard shortcuts
  • Undo / redo, autosave with retry, light and dark page themes (set per file type in settings)
  • Find and replace with whole words, regular expressions and ignore accents, including speaker notes, comments and cell notes
  • Search inside every document, deck and sheet in the vault from a side panel
  • Read-only mode in settings: view files without any chance of changing them
  • Version history: earlier versions are kept (in the app, not the vault) before saving; File › Version history to preview, compare with the file now, and restore
  • Export to PDF; slides to PNG, sheets to CSV
  • New document / presentation / spreadsheet commands, or New from template from a folder of your own files (Office .dotx / .potx / .xltx too, which also open for editing as templates); macro-enabled .docm / .pptm / .xlsm open with their macros kept, never run
  • File › Properties: title, author, keywords and description, searchable from the vault search
  • No Office or other software needed; works offline and on mobile

Notes and Markdown

  • Companion note: the notebook button beside history and comments creates or reopens a Markdown note beside the Office file, with a source link and editable tags, project and status properties
  • Create note from selection in Edit: document text, selected slide text or the current slide, and spreadsheet cells become a new note with a link back to the source heading, slide or range
  • Export current note to .docx: headings, lists, tasks, callouts, code (with syntax highlighting), tables, equations, pictures and links back to Obsidian
  • Export to Markdown from a Word file, keeping frontmatter, tasks, callouts and code languages from notes exported here
  • Export current note to .docx also brings in embedded files: sheets as tables, slides as pictures, documents as their content
  • Embed a file in a note: ![[report.docx]], ![[deck.pptx#3]], ![[budget.xlsx#Sheet2]], or just a range: ![[budget.xlsx#Sheet2!A1:D10]]; an embedded sheet shows its charts and pictures
  • Paste Markdown: text copied from a note pastes into documents as headings, lists, tasks, quotes, code boxes, tables, links, callouts, equations and the vault's pictures, and into slides as bullets, numbering, bold, links and pictures; Paste without formatting drops the Markdown syntax
  • Copy as Markdown: a sheet range as a Markdown table, a deck as a headed outline
  • Links to a place in a file: [[deck.pptx#5]], [[budget.xlsx#Sheet2!B4]], [[report.docx#Results]] open at that slide, cell or heading; Edit › Copy link makes them
  • A section of a document: ![[report.docx#Results]] embeds just that heading's section
  • Live cell values: `cell: budget.xlsx#Sheet2!H9` in a note shows the cell's value and follows the sheet
  • Linked from: see which notes link to a file, grouped by slide, cell range or heading; linked slides, headings and cells are marked
  • Files changed by sync or another app reload by themselves; sheets import .csv and .tsv files as new tabs (File › Import)

A note with an embedded slide and a sheet range

Searching inside documents, slides and sheets from the side panel

Install

  • Community plugins (once listed): search "Doc Works".
  • BRAT: add zarnuq/DocWorks.
  • Manual: copy main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/doc-works/ and enable it.

If another plugin already opens .docx, .pptx or .xlsx, disable it to use Doc Works for that type.

Contributing

Found a file that renders wrong? Open an issue with the file or a screenshot next to Office's rendering. PRs welcome; see CLAUDE.md for the architecture.

npm run dev    # watch build
npm test       # vitest
npm run lint   # Obsidian plugin rules

License

GPL-3.0

About

Obsidian Plugin that lets you open, read and edit Word and PowerPoint files right inside Obsidian.

Topics

Resources

Stars

17 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages