Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Handwriting Natively

Marwan LuayMarwan Luay3k downloads

Locally handwrite on PDFs with a stylus or mouse.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates330

Handwrite on PDFs, supported static PNG/JPEG images, and Markdown Reading or editing views in Obsidian. Confirmed stylus input annotates by default; mouse annotation and finger drawing are separate opt-in settings. Committed text boxes retain touch editing when touch drawing is off, and a completed one-finger double-tap can switch between the eraser and the previous tool. On compatibility-checked iOS, iPadOS, and Android PDF pages, one finger pans and two fingers pinch; unsupported and unsafe surfaces keep native viewer gestures. Markdown ink and text annotations use the same floating toolbar, tools, undo/redo, and vault sidecars as PDF and image annotations. Source and Live Preview keep native typing, selection, and scrolling. Explicit page insert/delete/import/scan actions update the open PDF and remap its sidecar atomically. Export PDFs as flattened or editable copies, or export an annotated image as a bounded flattened copy in its source PNG/JPEG format. Text boxes are sidecar-backed and editable in Text mode; physical eraser tips and optional whole-stroke erasing are supported.

I made this plugin after realizing I use Obsidian a lot more than another nameless note taking app.. I hope you find it as useful as I do!

Handwriting Natively drawing toolbar on a Lorem Ipsum PDF

  • Pen, graphite pencil, highlighter, laser pointer, eraser, and lasso tools in a movable toolbar
  • Stylus annotation by default, with optional mouse/touch drawing and compatibility-checked mobile PDF pan/pinch
  • Autosaving, everyones favorite feature
  • Commands to create a GoodNotes-inspired blank PDF notebook and hotkeys for tools, undo, and redo

Setup

Quick Start

  1. Look in Obsidian Plugins.
  2. Look up Handwriting Natively.
  3. Install and open a supported PDF, image, or Markdown file.

Manual Setup

  1. Install the BRAT plugin.
  2. Open BRAT and paste in https://github.com/MarsLuay/handwriting-natively.
  3. Select a release (the latest pre-release is my pick), install it, then open a supported PDF, image, or Markdown file.

PDF viewer ownership

Direct PDF leaves use the plugin-owned public ItemView. PDF.js remains the parser, text, annotation, and raster-rendering engine, while the plugin owns the page shells, scroll/zoom state, and same-DOM handwriting overlays. The shared toolbar provides page navigation, page-number entry, zoom presets, fit-width, rotation, outline and thumbnail sidebars, document search, stylus hand-pan, presentation mode, print, and download. Embedded PDFs remain in their host-owned viewer. The pinned PDF.js and pdf-lib runtimes are bundled into main.js, keeping BRAT installs self-contained because BRAT installs only the three standard plugin assets; no CDN or Obsidian private viewer DOM is required. If the bundled runtime cannot load, the direct view fails closed and offers the native Obsidian PDF viewer as a reversible fallback.

If you want..

If you like what I've made, I would deeply appreciate a donation to my https://buymeacoffee.com/marwanluaye! I need to support a coffee addiction but have to spend my spare money on silly things like a college education

License

MIT — see LICENSE.

If this project is used for any others, all that is required is acknowledging this repo and me. Thank you! Build cool things

Privacy

Local-only annotation processing. See PRIVACY.md and TERMS.md. No online telemetry or hosted service.

HealthExcellent
ReviewSatisfactory
About
Handwrite on PDFs with a stylus or mouse inside Obsidian using pen, graphite pencil, circular eraser, lasso tools, and a compact Draw toolbar. Store annotations as vault sidecars so originals stay untouched, export annotated PDFs when needed, and work entirely locally with opt-in Draw mode, autosave, recovery, and save/export/select commands.
PDFAnnotationDrawing
Details
Current version
0.1.59
Last updated
Last week
Created
4 months ago
Updates
330 releases
Downloads
3k
Compatible with
Obsidian 1.8.9+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Sponsor
Buy Me a Coffee
Author
Marwan LuayMarwan Luaymarsluay
github.com/MarsLuay
GitHubmarsluay
marwan-luay
  1. Community
  2. Plugins
  3. PDF
  4. Handwriting Natively

Related plugins

Handwriting

Handwrite, draw, highlight, and erase directly on your notes and PDFs. Your notes stay Markdown.

Handwritten Notes

Annotate PDFs and create handwritten notes inside your vault.

Ink-Annotation

Markdown/PDF handwritten annotation with pen, highlighter, eraser, color, width, undo, redo, save, and exit tools, plus PDF text selection annotation (highlight, underline, strikethrough, and notes).

Xournalpp

Integration with Xournal++ for handwritten notes and annotations.

ZotFlow

Read, annotate and cite your Zotero library in Obsidian: two-way sync, built-in PDF/EPUB reader, templated literature notes and CSL citations. #Zotero #PDF #Annotation

PDF Highlights

Extract highlights, underlines and annotations from your PDFs.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Admonition

Admonition block-styled content.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

Karpathy LLM Wiki

Karpathy's LLM Wiki implementation plugin for Obsidian - turns notes and PDFs into a linked, LLM-powered knowledge base with entity pages, concept pages, graph-powered Q&A, and local-first privacy.