Skip to content

Inkling 1.0.0

Choose a tag to compare

@github-actions github-actions released this 27 Sep 02:43
· 6 commits to Trunk since this release

The first release of Inkling: handwriting and annotation for PDFs and Markdown notes in Obsidian, built for a stylus and tested on an Android tablet with an S Pen.

What's in it

  • Annotate PDFs with a pen, highlighter, eraser, shapes, lasso selection and sticky notes. Ink is saved into the PDF as standard annotations, so other PDF readers show it too.
  • Highlights become notes. "Extract annotations to a note" turns highlights and comments into Markdown, grouped by page, each linking back to its page.
  • Handwritten notes. Create a blank, lined or dot-grid notebook and write straight into it, adding pages as you go.
  • Ink blocks in Markdown. "Insert ink annotation block" puts a drawing surface in the middle of a note. Its strokes are kept in an .ink file beside your attachments, so the note itself stays small and readable.
  • Saves that stay small. Most PDF saves append only what changed — a kilobyte or two, even on a textbook — so sync uploads the change rather than the book.
  • Feels like ink. Pressure-sensitive, curve-smoothed strokes, palm rejection, and pinch zoom.

Installing

Inkling is not in the community plugin catalogue yet.

  • With BRAT: install BRAT from Community Plugins, choose Add Beta Plugin, give it Bluewolf135/Inkling, then enable Inkling.
  • By hand: download main.js, manifest.json and styles.css below into <vault>/.obsidian/plugins/inkling/, then enable Inkling in Community Plugins.

Requires Obsidian 1.13 or later, on desktop or mobile.

Known limitations

  • Renaming or moving an .ink file shows its blocks as missing, read-only, until the file is moved back. Renaming the note is fine.
  • PDFs with forms or digital signatures, and a few with unusual structure, open read-only on purpose, with a banner saying why.
  • Ink blocks render only inside Obsidian.

See the README for the details.