Skip to content
Nat Lee

Keyboard shortcuts

Turn these off if they get in the way of a screen reader or voice control. The setting is saved in this browser.

1
Home
2
Work
3
Projects
4
About
5
Experience
/
Search projects
?
Show this panel

Productivity Tools

Obsidian Word Mode

Word-style Editor Plugin for Obsidian

An Obsidian plugin for editing Markdown notes like a Word document, with a ribbon toolbar, tables and images, while the file on disk stays clean Markdown. For people who know Markdown and would still rather click Bold.

Role
Creator & Maintainer
Period
2026 – Present
Status
Active
Categories
Web apps & extensions
Obsidian Word Mode, screenshot 1

Overview

Word Mode adds a second editor for Markdown notes in Obsidian: you see formatted text instead of Markdown syntax and format with toolbar buttons and familiar word-processor shortcuts. Files stay plain Markdown. When a note is edited, only the changed blocks are written again and everything else is kept character for character; anything it cannot edit visually, such as HTML blocks, is shown as a raw block and saved unchanged. It covers a ribbon toolbar with Home, Insert, Review and View tabs, in-place tables, a properties form, images, links, find and replace, an outline sidebar, formatting as you type, Mermaid diagrams with a diagram editor, a visual equation editor, embeds, footnotes, callouts and task lists, plus a choice of versions when a note changes on disk during unsaved edits. The interface comes in Traditional Chinese, English, Japanese and Korean. It is written in TypeScript on ProseMirror and markdown-it, bundled with esbuild, and tested with editing tests that simulate Obsidian in jsdom and a read-only round trip over a real vault. No telemetry, and it never touches files outside the vault.

Why I built it

In Obsidian, formatting a note still means Markdown syntax; even the shortcuts just type the symbols for you. Word Mode lets you work with toolbar buttons and word-processor shortcuts on the same .md files, and writes back only the blocks you changed, so fixing one typo doesn't turn into a diff of the whole note.

What it's good for

Someone who has never typed a Markdown asterisk can work in the same vault: tables, properties, images, diagrams and equations all have buttons. The files stay ordinary .md, so sync and other tools never learn that someone switched editors.

How it works

  1. Edit the note in Word modeAutosave follows your edits
  2. File changed elsewhere meanwhile?
    → yesno → Rewrite only the changed blocks
  3. Pick the version to keepTheirs, yours, or both
  4. Rewrite only the changed blocksThe rest stays character for character
  5. Save the same .md fileRaw blocks saved unchanged

The problem

  • Editing notes visually without changing the Markdown the user didn't touch
  • Testing an editor that only runs inside Obsidian
  • Relying on Obsidian APIs that aren't public

What I did

  • Only blocks that changed are serialized again, and a read-only round trip over a real vault (notExact and lossyBlocks must both be 0) guards the converter
  • Editing tests simulate Obsidian with jsdom, and ESLint runs the rules Obsidian uses to review community plugins
  • Non-public APIs are declared in one place, each optional and checked before use; the obsidian typings are pinned to the minimum supported app version

Results

  • Notes stay clean Markdown; anything it can't edit visually is saved unchanged
  • Released on GitHub; install by copying three files into the vault's plugins folder
  • No telemetry, no account, and no files touched outside the vault

Features

  • Ribbon toolbar with Home, Insert, Review and View tabs
  • Only changed blocks are rewritten; the rest of the file stays character for character
  • Tables edited in place, including sorting and pasting cells from a spreadsheet
  • Properties as a form, with tags and links as chips
  • Images you can paste, pick and resize by dragging
  • Formatting as you type, with each change as its own undo step
  • Mermaid diagrams with a diagram editor, and a visual equation editor
  • Embeds, footnotes, callouts and task lists with custom statuses
  • Find and replace, outline sidebar and heading folding
  • Sync conflict handling when a note changes on disk during unsaved edits
  • Interface in Traditional Chinese, English, Japanese and Korean

What I learned

  • The release tag must match the version exactly, with no v in front, because Obsidian looks for a release under that exact tag.
  • Keep the source folder and node_modules out of folders a sync client watches, such as Synology Drive.
  • Not checked yet: mobile use on real devices, and the Japanese and Korean translations by native speakers.

How it fits together

Simplified on purpose. The real thing has more arrows and at least one config file nobody understands.

  1. Markdown note
    • .md file in vault
    → opens in
  2. This oneWord Mode editor
    • markdown-it parser
    • ProseMirror document
    • Ribbon toolbar
    → changed blocks only
  3. Same .md file
    • Plain Markdown on disk
  • Obsidian Word Mode, screenshot 2
  • Obsidian Word Mode, screenshot 3
  • Web apps & extensions77 stars on GitHub

    Streaming Player

    Twitch, YouTube live chat and chat bots share one song queue. A Rust backend keeps the OBS player, overlay and moderator dashboard in sync.

    2023Completed
  • Web apps & extensions11 stars on GitHub

    Gantt Studio

    Drag a schedule into place, draw dependencies and see the critical path. Switch to Mermaid text without losing the plan. Everything stays in your browser.

    2026Completed
  • Web apps & extensions33 stars on GitHub

    MorphKit

    Converts and edits images, audio, video, PDFs and documents entirely in the browser. Nothing gets uploaded, mostly because there is nowhere to upload it to.

    2026Active