π PutDoc β A Smarter Document Editor for Developers
https://github.com/johnwaynecornell/PutDoc
PutDoc is a next-generation document editor designed for people who think in code, markup, and structure.
It blends the precision of a developer tool with the ease of a modern writing environment β and itβs open-source.
If youβve ever wished your editor understood your content instead of just displaying it, PutDoc was built for you.
β¨ What Makes PutDoc Different
π Rich Paste β Bring Anything In, Beautifully
PutDoc includes a custom HTML ingestion system that can take messy clipboard input β code blocks, mixed formatting, IDE exports, PDFs, even ChatGPT transcripts β and convert it into clean, consistent, structured HTML.
You donβt paste garbage.
You paste content thatβs ready to work with.
π§± Snippet-Based Composition
Documents are built from snippets β self-contained segments that can be edited, moved, and transformed independently.
You get:
- Structure without rigidity
- Clean separation between narrative, code, and examples
- Easier editing
- Zero accidental breakage
It feels like using a document editor with the precision of a component system.
ποΈ Live HTML Editing with Smart Tools
The built-in HTML editor includes:
- Line/word selection tools
- Caret tracking with intelligent highlighting
- Smooth scroll-to-selection
- Undo/redo ring buffer
- Manual βSave Nowβ and debounced autosave
- Freeze mode for safe bulk edits
- Inner/outer fragment editing
Itβs a deceptively powerful system.
β‘ Real-Time DOM Enhancement
As you write, PutDoc enriches your document with contextual toolbars and visual helpers via a lightweight JS layer.
Editing feels alive without ever being distracting.
π Presence & Writer Locks
When the same document is open in multiple windows, PutDoc coordinates:
- who is editing
- who is viewing
- who holds save permission
This keeps your content stable without interfering with workflow.
π§© Why You Might Want PutDoc
PutDoc is perfect for:
- writing technical articles
- designing specs
- documenting code
- preparing knowledge frameworks
- composing symbolic or structured content
- turning ChatGPT output into clean, exportable pages
- maintaining unified documents from many sources
If you build tools, frameworks, or structured knowledge β you will feel at home immediately.
π οΈ Open Source β Built to Build
PutDoc isnβt a SaaS product.
Itβs a self-hosted app you build locally.
What you need:
- .NET 8 SDK
- Git
- Clone the repo:
git clone https://github.com/johnwaynecornell/PutDoc.git - Run it:
cd src/PutDoc dotnet run
PutDoc is intentionally local, private, and developer-friendly.
If you want to extend it β C# and JavaScript source are right there.
If you want to keep your documents offline β they stay in your workspace.
If you want full control β you have it.
π± A Tool for Builders, Thinkers, and Framework Architects
PutDoc is not a generic editor.
Itβs a precision writing instrument for people who shape ideas, build systems, and organize knowledge.
Whether you’re documenting a framework, writing a spec, creating a knowledge lattice, or composing symbolic structures β PutDocβs workflow supports the way deep thinkers actually work.
π Want to Try It?
The repo is open:
https://github.com/johnwaynecornell/PutDoc
Clone it, build it, and make it your own.
If you enjoy tools that elevate how you think, I believe youβll love what PutDoc becomes.