Obsidian Stats logoObsidian Stats

Freedraw PDF

by vida sana
5
4
3
2
1
Score: 31/100
Install Code

Description

Reviews

No reviews yet.

Stats

3
stars
933
downloads
1
forks
57
days
11
days
11
days
1
total PRs
0
open PRs
1
closed PRs
0
merged PRs
1
total issues
1
open issues
0
closed issues
4
commits

Latest Version

0.13.3
12 days ago

Changelog

Freedraw PDF 0.13.3

This release improves handwriting, page handling, text editing, and saving. It continues the plugin's existing version series and uses the same freedraw-pdf plugin ID.

What's changed

  • Adjust stroke stabilization in settings. Each stroke keeps its own rendering settings, so changing preferences does not alter existing handwriting when you reopen, zoom, or export.
  • Balanced and Accurate previews use consistent stroke geometry while drawing and after pen-up. A zero-pressure pen-up sample retains the previous pressure.
  • Partially erased strokes have rounded cut ends, with tapering suppressed at the cut.
  • Page redraws reuse unchanged frames, and selection dragging caches stationary annotations to reduce repeated rendering.
  • Text editing uses the native caret and arrow navigation. While annotating, use 1 Pen, 2 Highlighter, 3 Eraser, 4 Select, 5 Text. These shortcuts leave typing and composition alone.
  • The toolbar uses horizontal inline or floating layouts.
  • Temporary pages appear beside their selected PDF page, including repeated quick additions. New PDFs have white source pages; change their paper colour and template through the page menu.
  • Saves queue pending edits and detect conflicting changes. Failed saves attempt a separate recovery copy, and unreadable annotation files block editing instead of opening an empty writable layer.
  • Annotation images must contain embedded image data. Test deployment copies the plugin files without uploading the whole vault to cloud storage.

Install

Download freedraw-pdf-0.13.3.zip and extract main.js, manifest.json, and styles.css into .obsidian/plugins/freedraw-pdf in your vault. Reload Obsidian and enable Freedraw PDF. Requires Obsidian 1.12.0 or later.

The repository and source archive contain one current plugin at the root. The installable ZIP contains only the three plugin files.

Before upgrading

Keep a backup of your PDFs and annotation files. Older strokes receive a fixed rendering baseline from the settings present at upgrade; appearances already changed by an earlier build cannot be reconstructed.

Physical pen latency, palm rejection, pinch zoom, and long-PDF behaviour still need device testing. Issue #2 is not confirmed fixed. Smooth preview can differ at pen-up. Exports remain flattened raster PDFs, and conflicting sidecars need manual reconciliation. Recovery depends on writable storage.

See the safety review for the checks and their limits.

See all version on GitHub

README file from

Github

Freedraw PDF

Write and draw on PDFs in Obsidian. Freedraw PDF lets you add handwritten notes, highlights, text, and images, insert extra writing pages, and export an annotated copy. Your original PDF stays unchanged.

Handwritten PDF annotations beside a live embed in an Obsidian note

The PDF is open on the left. On the right, an Obsidian note displays an annotated region from the same document.

What you can do

  • Write with a pressure-aware pen or highlighter, with separate colour and width settings.
  • Add text boxes, lines, rectangles, ellipses, and images.
  • Move, resize, duplicate, and reorder annotations. Erase whole objects or parts of a stroke.
  • Insert blank, ruled, grid, or dotted pages between PDF pages, with a choice of paper colours and sizes.
  • Show an annotated page or selected region inside a Markdown note.
  • Export the document, added pages, and annotations as a separate PDF.

Install

Freedraw PDF requires Obsidian 1.12.0 or later.

  1. Download the plugin ZIP from the latest release and extract it. You can also download main.js, manifest.json, and styles.css individually.
  2. In your vault, create the folder .obsidian/plugins/freedraw-pdf.
  3. Put those three files directly inside that folder.
  4. Reload Obsidian, then open Settings → Community plugins and enable Freedraw PDF.

Use the plugin assets from the release, rather than GitHub's automatically generated source-code archives.

Start annotating

Open a PDF and choose Annotate from its toolbar or the command palette. Select a tool, then write or place an annotation on the page. Choose Finish when you want to return to reading.

The toolbar sits inside Obsidian's PDF toolbar when available. You can choose a floating toolbar in the plugin settings.

To add writing space, open the page menu and insert a template page. The Pages menu lets you navigate, rename, duplicate, and manage pages. For sharing, use the export command in the overflow menu.

If you want to scroll with your finger and write with a pen, set Finger input to Pan with finger. Pen, highlighter, eraser, and text preferences are also available in the plugin settings.

Include annotations in your notes

Use the embed command to copy an annotated page or selected region into a Markdown note. The embed reads the saved annotations, so you can return to the PDF and keep editing.

You can also write an embed block yourself:

```freedraw-pdf
path: Documents/example.pdf
page: 1
width: 720
```

Change path to the PDF's location within your vault and page to the page you want to show.

Saving and exporting

Freedraw PDF stores editable annotations in a companion .annot.json file beside the PDF. Keep both files when backing up or transferring your work. Imported annotation images are stored with the annotation data.

Export creates a separate, flattened PDF. The exported annotations are part of the page image; keep the original PDF and annotation file if you want to edit them again in Freedraw PDF.

The plugin does not require an account or use analytics. Your vault's storage, backup, and sync settings determine where its files are kept.

Help and feedback

If the toolbar is missing, check Toolbar placement in the plugin settings. If finger scrolling draws unwanted marks, select Pan with finger.

Stylus input, palm rejection, and touch gestures can behave differently across devices. Check the open issues for existing reports, or describe the problem with your Obsidian version, plugin version, device, and steps to reproduce it. Share a sample PDF only if it contains no private information.

For security concerns, follow the security policy.

Contributing

See the contributor guide for local setup, checks, and contribution guidelines. The repository includes development changes that may not be available in the latest published release. Published changes are listed in GitHub Releases.

License

Freedraw PDF is released under the MIT License. Stroke rendering uses perfect-freehand, also licensed under MIT.

Sponsors