Skip to content

Releases

0.12.3 (public edition)

Choose a tag to compare

@github-actions github-actions released this 17 Nov 13:27

HandNote 0.12.3

  • Large PDF imports. The PDF file size limit rises from 200 MiB to 512 MiB. HandNote hashes the file in chunks and releases PDF inspection resources before saving a new copy to reduce peak memory use. A 400 MiB test PDF was successfully imported and opened on iPad. Actual capacity depends on the device and PDF contents.
  • Long PDFs. HandNote imports the full document up to 10,000 pages. Above that limit it asks you to split the PDF. Previous versions could silently stop at 2,000 pages.
  • Clearer errors. HandNote checks the header of a picked file before reading the full file. An all-zero header now gets an explanation about possible placeholders, damage, or incomplete downloads.

Update through Settings → Community plugins → Check for updates.

中文

  • 大 PDF 导入。 PDF 上限从 200 MiB 提升到 512 MiB。分块校验,并在保存新副本前释放 PDF 解析资源,降低导入时的内存峰值。已在 iPad 上成功导入并打开一份 400 MiB 测试 PDF。实际可导入大小取决于设备和 PDF 内容。
  • 长 PDF 完整导入。 最多完整导入 10,000 页。超过上限会提示拆分,修复了旧版在 2,000 页处静默截断的问题。
  • 更清楚的文件提示。 从设备导入时先检查文件头。遇到全零开头会提示可能是占位文件、损坏或下载不完整。

在 Obsidian 的 设置 → 第三方插件 → 检查更新 中升级。


SHA-256

d95dea564e70dee04da180c094b0052e477bb9ae04c982d12e187e140c7e6774  main.js
085ddc705fcecd51d91ad7da571945130b2a5c3c52adb93310452b6525e16162  manifest.json
fd64a31534a8abff75e1800ed57af8837bf61dc022b294caebe863f168af9f5a  styles.css

0.12.2 (public edition)

Choose a tag to compare

@github-actions github-actions released this 17 Nov 13:17

HandNote 0.12.2

  • Drawing tablet cursor. Choose Small dot or Crosshair under Settings → HandNote → Writing → Writing cursor. Crosshair remains the default. Your choice takes effect immediately and is saved.
  • Write while scrolling on iPad. When a HandNote page is still coasting after a swipe, touching it with Apple Pencil stops the page and starts the stroke at the point of contact.
  • Recover from interrupted input. If a pen or mouse release is missed, the next contact can start a new stroke. A cancelled drag now clears the dragging state.

Update through Settings → Community plugins → Check for updates.

中文

  • 数位板光标。 在 设置 → HandNote → 书写 → 书写光标 中选择「小圆点」或「十字」。默认使用十字,切换即时生效并保存。
  • iPad 落笔即停。 手指滑动后,即使页面仍在惯性滚动,Apple Pencil 落笔时页面也会立刻停住,笔迹从落点开始。
  • 输入中断后恢复。 系统漏发抬笔或鼠标释放事件时,下一次接触可以开始新笔划。拖动取消时会退出拖动状态。

在 Obsidian 的 设置 → 第三方插件 → 检查更新 中更新。


SHA-256

e9d60c4bc7247af84447f97ac91da14ee00640e8397af0d0de90ac4de15c9c1b  main.js
3bace3a31084b289931bd5210fdbe34fbbf3adb7daa45b13afe78ee99d52fd82  manifest.json
fd64a31534a8abff75e1800ed57af8837bf61dc022b294caebe863f168af9f5a  styles.css

0.12.1 (public edition)

Choose a tag to compare

@github-actions github-actions released this 10 Nov 16:42

HandNote 0.12.1

Ink on Markdown: write by hand directly on your ordinary Markdown notes, in Obsidian's own
editor, with the same tools as in a HandNote note. Your .md file is never changed: the ink is saved
in a separate annotation file. Also: the shape pen recognises gently bent lines as curves.

Notes made with earlier versions open as before.

Ink on Markdown

  • Turn it on with the HandNote pen icon at the top right of a Markdown tab, or with the command
    Turn HandNote annotation on / off for the current Markdown note. The HandNote toolbar appears
    above the note. Tap the icon again, or Done on the toolbar, to turn it off. A note in reading
    view switches to the editing view.
  • The note stays an editable note. With a pen, eraser, lasso, laser or the hand tool selected,
    the Apple Pencil only writes: it does not move the cursor, select text or start Scribble. Tap the
    text with a finger
    to type right there; when the keyboard closes or the Pencil touches the
    screen again, the Pencil writes again. Links, checkboxes and fold arrows react to a finger tap as
    usual.
  • Tools, as in notes: fountain pen, pencil, highlighter and the shape pen (real shapes and
    connectors; draw a "V" at the end of a line to add an arrow head); eraser; the HandNote lasso (move, resize, rotate, copy, cut, delete, recolour, group: ink, text
    boxes, images and shapes); text boxes (tap anywhere, also in the margin); images (stored in the
    annotation file, large images are scaled down first); shapes; laser pointer; undo / redo, also
    with a two-finger / three-finger tap.
  • Gestures, as in notes: one finger pans with inertia, also sideways into the margin (up to half
    a screen, or as far as your outermost annotation); two fingers zoom from 50 % to 800 %, and the
    text is laid out again at the new size, so it stays sharp and editable. Tap the zoom percentage
    to go back to 100 %. On a computer, the mouse or a pen tablet draws, and Ctrl/⌘ + wheel or a
    trackpad pinch zooms.
  • Annotations follow the text. Every stroke, text box, image and shape belongs to the line next
    to it: add or delete lines above it and it moves with that line. A highlighter laid on words
    follows those words
    , also when text is inserted before them in the same paragraph or they wrap
    to the next row (the highlight then splits into one piece per row). When the note is changed
    elsewhere, annotations find their line again by line number and text; an annotation whose line
    cannot be found stays where it was and is never deleted.
  • Saving: the ink is saved automatically in HandNote annotations/<path of the note>.handnote,
    an ordinary, visible folder that syncs like the rest of your vault. Nothing is written into the
    Markdown file. The same safety as notes: a version check before writing (a file changed elsewhere
    is kept as a copy), a recovery journal, and a damaged annotation file opens read-only. Renaming or
    moving a note moves its annotations; deleting a note keeps them. A second tab on the same note
    shows the ink read-only, so the two cannot overwrite each other.
  • ⋯ menu: save now, clear all annotations (ink, text boxes, images and shapes; one undo brings
    everything back), exit, and Copy diagnostics (page structure and settings only, no note text).

Shape pen

  • A gently bent line is a curve (in notes too). A line that bends smoothly to one side by about
    4.5 % of its length is now a curve; before, it had to bend by more than 10 %. Hand tremor, which
    wobbles to both sides, still gives a straight line. In a simulated test, all 108 casual straight
    lines (bent up to 3 %) stayed straight, and 87 % of smooth 6–9 % bends became curves (before: 5 of
    108). Handwriting is not mistaken for shapes more often than before.

Known limitations of Ink on Markdown

  • The ink is shown only in the editing view, not in reading view and not where the note is
    embedded in another note.
  • No PNG / PDF export of an annotated Markdown note yet.
  • The lasso has no Convert and AI buttons on Markdown notes.
  • Ink follows its line, not the shape of the sentence: words added in the middle of a circled
    sentence do not stretch the circle. Moving or resizing a highlight with the lasso makes it ordinary
    ink again. Inside callouts and tables, highlights follow the block's line, not single words.
  • In Live Preview, the line with the cursor shows its Markdown source (for example **bold**, a
    formula or a table). While that line is wider or taller, the ink beside it is briefly out of place;
    it returns when the cursor leaves the line.
  • On another device with a different font, font size or window width, ink still follows its line,
    but its horizontal position can differ.
  • Opening an annotation file from HandNote annotations/ directly shows the ink without the text.

Compatibility

  • An annotation file is an ordinary .handnote file; the file format version is unchanged. It has a
    few new optional fields: the annotated note (annotates), the line a stroke or object belongs to
    (a, anchor) and the words a highlight covers (sp). HandNote 0.11.1 and older open these files
    as ordinary notes and drop the new fields when they save.
  • The Markdown notes themselves are never written by this feature.

中文说明

  • 在 Markdown 笔记上直接手写批注:点 Markdown 标签页右上角的 HandNote 笔尖图标,或用命令「在当前 Markdown 笔记上打开 / 关闭 HandNote 批注」。笔记上方出现 HandNote 工具栏;再点一次图标或点「完成」关闭。笔记在阅读视图时会切到编辑视图。
  • 笔记仍然可以编辑:选笔、橡皮、套索、激光笔或抓手时,Apple Pencil 只写字,不会移动光标、选中文字或触发随手写(Scribble)。用手指点一下正文就能在那里打字;键盘收起或 Pencil 再碰屏幕时,Pencil 继续写笔迹。手指点链接、复选框、折叠箭头和平时一样。
  • 工具和 HandNote 笔记一样:钢笔、铅笔、荧光笔和形状笔(真正的形状和连接线,在线的末端画「V」加箭头);橡皮擦;HandNote 套索(移动、缩放、旋转、复制、剪切、删除、改色、编组,笔迹、文本框、图片、形状都能套);文本框(点哪里就在哪里,也可以放在页边);图片(存进批注文件,太大的会先缩小);形状;激光笔;撤销 / 重做,也可以双指 / 三指轻点。
  • 手势和笔记一样:单指拖动带惯性,也可以左右拖到页边(最多半屏,或一直拖到最外侧的批注旁边);双指缩放 50%–800%,正文按新大小重新排版,保持清晰、可以编辑。点缩放比例回到 100%。电脑上鼠标或数位板写字,Ctrl/⌘ + 滚轮或触控板捏合缩放。
  • 批注跟着文字走:每一笔、每个文本框、图片、形状都属于旁边那一行,上面加行、删行时跟着这一行移动。荧光笔划过的字,荧光笔就跟着这几个字:同一段前面加字、被标的字折到下一排时也跟过去(折成两排时分成两段)。笔记在别处被修改后,按行号和文字重新找到它的行;找不到时留在原处,绝不会被删除。
  • 保存:自动保存在 HandNote annotations/<笔记路径>.handnote,是普通的可见文件夹,和仓库其他内容一样同步。Markdown 文件里不写入任何东西。和笔记一样有写入前的版本检查(被别处改过就另存副本)、恢复日志,批注文件损坏时只读打开。笔记改名、移动时批注跟着走;删除笔记时批注保留。同一篇笔记在第二个标签页里只读显示,避免互相覆盖。
  • 「⋯」菜单:立即保存、清除所有批注(笔迹、文本框、图片、形状一起清,撤销一次全部回来)、退出批注、复制诊断信息(只含页面结构和设置,不含笔记文字)。
  • 形状笔:稍微弯一点的线也认成曲线(笔记里同样生效):平滑地往一边弯出约 4.5% 就算曲线,以前要超过 10%。手抖造成的两侧来回摆仍然认成直线。模拟测试:108 条弯曲 3% 以内的随手直线全部仍是直线,弯出 6–9% 的平滑弯线 87% 认成曲线(以前 108 条里只有 5 条);手写文字被误认成形状的比例没有变化。
  • 已知限制:只在编辑视图显示笔迹,阅读视图和嵌入到其他笔记里时看不到;还不能把批注过的 Markdown 笔记导出为 PNG / PDF;Markdown 笔记里的套索没有「转换」和「AI」按钮;笔迹跟着行走,不随句子变形(在被圈的句子中间加字,圈不会变长);用套索移动或缩放荧光笔后,它变回普通笔迹;标注框(callout)和表格里的荧光笔按整块的行跟随;实时预览中光标所在行显示源码,变宽或变高时旁边的笔迹会暂时错开,光标移开就恢复;字体、字号、窗口宽度不同的设备上,笔迹仍跟着行,但横向位置可能有偏差;直接打开 HandNote annotations/ 里的文件只能看到笔迹,看不到正文。
  • 兼容性:批注文件是普通的 .handnote 文件,文件格式版本不变,只多了几个可选字段(annotates、a、anchor、sp)。0.11.1 及更早版本会把它当作普通笔记打开,保存时丢掉这些字段。这个功能从不写入 Markdown 笔记本身。

SHA-256

25401a667fbd0bc69ff0467ff041274aba3abcb0c2229a4c19ac44f125eeea69  main.js
9a8056db7095e4eb5876434bfcabaf87478c02748cf3f57c459aec35ae74de01  manifest.json
d7da80fd09717c68f8f9fac22664a4ed987f3b65e2fa2f47b05e2ab40b045a1d  styles.css

0.11.1 (public edition)

Choose a tag to compare

@github-actions github-actions released this 05 Nov 05:26

HandNote 0.11.1

Smoother handwriting on the iPad, pointed stroke ends, Apple Pencil tilt, pressure calibration for
every pen, and page bookmarks. Notes made with earlier versions open as before, and strokes written
before keep their look.

Writing

  • Straight lines no longer look pieced together on the iPad. iPadOS often hands HandNote the
    Apple Pencil points of one frame twice. Both copies were used, so the ink stepped back and forward
    about 120 times a second, which showed as small steps along the edge of long strokes. Repeated
    points are now ignored. In one real note, half of all points were such repeats.
  • Pointed stroke ends (笔锋) are back. A quick flick ends in a sharp point, a slow stop stays
    rounder. The point never reaches past the ink you saw while writing; it only sharpens the round
    end. Strokes also start slightly narrower and grow to full width.
  • Smoother edges. The width is smoothed over a longer stretch, and the two sides of a stroke are
    drawn as curves, so there is no corner at each outline point (on screen and in SVG export).
  • Light writing is as smooth as firm writing. Single pressure dropouts of a light touch are
    filtered out, and light strokes are smoothed a little more.
  • Pen tilt. A tilted Apple Pencil writes wider: new setting Tilt widens in the pen settings
    (default 40 %, so +20 % at 45°; 0 turns it off). The highlighter, the mouse and pens without tilt
    data are not affected.
  • Pressure calibration for every pen. Calibrate from my writing (pen settings → Advanced) no
    longer needs the input diagnostics: write a few lines, tap it, and your typical and heavy pressure
    are measured from your last Pencil strokes. The fountain pen, pencil and ballpoint pen all use it.
  • The pencil and ballpoint pen reach their set width. They assumed a fixed typical pressure of
    0.3, far above real Pencil writing (about 0.06–0.12), so they wrote at about half their width.
    They now use the calibrated pressure (0.12 until you calibrate). The pencil writes thicker than
    in 0.11.0
    ; lower its width if you preferred it thinner.

Page bookmarks

  • Bookmark a page with the bookmark at the top right of its thumbnail in the page sidebar
    (it turns red), with Add to favorites in the editor's ⋯ menu or a thumbnail's ⌄ menu, or with
    the command Bookmark / unbookmark the current page.
  • All pages / Bookmarks only: the button at the top of the page sidebar lists only the
    bookmarked pages; tap one to jump to it.
  • Bookmarks are saved in the note and sync with it. They are not undo steps. They move with their
    page; whiteboards have no page bookmarks.

Compatibility

  • A bookmark is one optional field on the page ("bookmark": true); the file format version is
    unchanged. HandNote 0.11.0 and older open and edit these notes normally but do not show the
    bookmarks, and drop them when they save.

中文说明

  • iPad 上直线不再一节一节的:iPadOS 经常把同一帧的 Apple Pencil 采样点送两遍,以前两份都用了,笔迹每秒往回跳约 120 次,长笔画的边缘出现小台阶。现在重复的点会被丢掉(一份真实笔记里一半的点是重复的)。
  • 笔锋回来了:快速甩出收成尖,慢慢停笔保留圆一些;笔尖不会超出书写时看到的墨迹,只是把圆头削尖。起笔也从稍细长到正常宽度。
  • 边缘更平滑:宽度沿笔画平滑得更长,笔画两侧改成曲线,轮廓点处没有折角(屏幕和 SVG 导出一样)。
  • 轻轻写也平滑:轻压时偶尔掉下去的压力会被滤掉,轻写的笔画平滑得更多一点。
  • 笔斜着写会变宽:笔设置里新增「倾斜加宽」(默认 40%,笔斜 45° 时宽 20%,设为 0 关闭)。荧光笔、鼠标和没有倾斜数据的笔不受影响。
  • 所有带压感的笔都能校准:笔设置 → 高级设置里的「根据我的书写校准」不用再先打开输入诊断,写几行字后点一下即可;钢笔、铅笔、圆珠笔都用这个校准值。
  • 铅笔、圆珠笔达到设定的粗细:以前它们按固定的常用压力 0.3 计算,远高于 Pencil 实际书写的 0.06–0.12,只画出一半左右的宽度;现在用校准值(没校准时 0.12)。铅笔会比 0.11.0 粗,觉得太粗可以调细。
  • 页面收藏:点页面栏缩略图右上角的书签(变红),或在 ⋯「更多」、缩略图的 ⌄ 菜单里选「添加到收藏夹」,也可以用命令「收藏 / 取消收藏当前页」。页面栏顶部可以切换「所有页面 / 仅书签」。收藏随笔记保存和同步,不算撤销步骤,跟着页面移动;白板没有页面收藏。
  • 兼容性:收藏只在页面上多一个 "bookmark": true,文件格式版本不变;0.11.0 及更早版本能正常打开和编辑,只是看不到收藏,保存后收藏会丢失。之前写的字保持原样。

SHA-256

cecbb3eec95b66120173e38182bb82ea2771ed25e016ea8fa7baf560b932d8fd  main.js
a3ef88d0d357570c53fcd0dd2834094ce299c1a5a56c91480b241115cc5803f8  manifest.json
eb7d320f77b27512db8959e5aa083aa89126e56a87a3be4fff2728868accf1db  styles.css

0.11.0 (public edition)

Choose a tag to compare

@github-actions github-actions released this 04 Nov 16:33

HandNote 0.11.0

Infinite whiteboards, ink that stays exactly where you wrote it, a better shape pen and faster
navigation. Tested on the iPad over five private rounds. Notes made with earlier versions open as
before.

Infinite whiteboard

  • New whiteboard: the HandNote ribbon icon now asks Handwritten note or Infinite
    whiteboard
    (also the command New infinite whiteboard). One canvas without edges, dotted by
    default, zoom out to 10 %.
  • Turn a note into a whiteboard: Change template → Infinite whiteboard (or the command). The
    pages are laid out from left to right as page frames, with their paper, their imported PDF /
    Word / PowerPoint / Excel page and your ink. It is one undo step back to the note with pages.
  • Page frames move with the lasso: circle a whole frame to drag it (with its ink) or delete it.
  • The page counter becomes the zoom level (tap it for Show all or 100 %); previous / next jump
    between frames; Back to content appears when you wander off.
  • Export the whole whiteboard (PNG / SVG, scaled down when very large) or the current view; embed
    it in Markdown with ![[Board.handnote]].
  • Large whiteboards draw only what is on screen and simplify when zoomed far out (50 000 strokes
    stay smooth on the desktop).

Writing

  • The ink no longer moves when you lift the pen. A stroke is now saved exactly as it was drawn
    on screen, and reopening a note shows the same ink. Two causes of a small jump on lift were also
    fixed: the page canvas and the live ink layer could sit half a pixel apart, and the last point
    (pressure 0 on every device) thinned the end of each stroke.
  • Smoother lines. New strokes are smoothed along their length without lagging behind the pen:
    hand tremor is evened out, corners (横折, 竖钩) stay sharp, small loops keep their shape. Measured
    on simulated Pencil input, the wobble of a straight line drops to about a sixth.
  • Smooth outline. The edge of a stroke is one smooth outline instead of many joined segments,
    so no small bumps where the width changes. Sharp turns are still drawn exactly; translucent ink
    still never darkens where it overlaps.
  • No exit taper added on lift: the end of a stroke stays as you drew it.
  • Zoom up to 2400 %, round edges at any zoom, and the page is redrawn sharp during a long pinch
    (only when that is cheap enough, so pinching stays fluid).
  • Strokes written before 0.11 look exactly as before.

Shape pen

  • No dashed preview while drawing; the shape replaces the ink right after you lift the pen.
  • Casual straight lines are recognised at any angle, also when drawn slowly and lightly
    (recognition now uses the smoothed ink, not the raw jittery points).
  • U, V, S, J and the arm of a "k" are recognised: open bends become curves you can edit;
    recognition works in screen pixels, so it behaves the same at 800 % as at 100 %.
  • Tilted ellipses and rectangles keep their tilt.
  • Pentagons, hexagons … (5–8 sides) are recognised and snapped to a regular polygon when the
    sides and angles are nearly equal.

Highlighter

  • A nearly straight highlighter stroke becomes an exactly straight line. Can be turned off in the
    editor's ⋯ menu or in Settings (Straighten highlighter lines).

Navigation

  • Hand tool in the toolbar (H on the desktop): pen, mouse and finger only move the page.
  • Every tool and page action is a command, so you can give it a hotkey in Settings → Hotkeys.
  • Go to page: tap the page counter (5/6) and type a number; imported pages show their page in
    the original document.
  • PDF contents: a PDF with bookmarks gets a Contents tab in the page sidebar.
  • Pull to add a page: keep pulling past the bottom of the last page until the circle fills,
    let go, and a page is added (setting Add a page by pulling past the last page).

Settings

  • Grouped into New notes, Writing and Images, documents and embeds; Recognition and AI
    and Advanced are folded away. All labels are translated. No setting was removed and your values
    are kept.

Compatibility

  • Whiteboards and the new curve shapes use file format 7: HandNote 0.10 and older open them
    read-only. Notes with pages are written in the same format as before.
  • New strokes also store the drawn ink beside their points, so files with new handwriting are
    about 1.6–1.9 times larger. Older HandNote versions still open and edit them (they redraw the ink
    from the points).

中文说明

  • 无限白板:点左侧 HandNote 图标选「无限白板」新建,默认点阵、没有边界、可缩小到 10%。分页笔记可以一键转成白板(各页从左到右排成页面框,保留纸张、导入的文档和字迹),一步就能撤销回去。套索圈住页面框可以整体移动;可导出整块白板或当前视图,可嵌入 Markdown。
  • 松手字不再动:笔画按屏幕上画出来的样子保存,重新打开也一样;修好了画布差半个像素、最后一个点压力为 0 使末端变细这两个松手跳动的原因。
  • 线条更顺滑:新写的字沿笔画平滑,不落后笔尖,拐角保持尖锐;笔画边缘改成一条平滑轮廓,没有小折角;松手不再加出锋。
  • 最大放大到 2400%,放大后边缘仍是圆的,双指缩放时也会适时重画清楚。
  • 形状笔:去掉画时的虚线预览;随手画、轻轻慢慢画的直线都能认出;能认 U、V、S、J 和 k 的右半边;斜椭圆、斜矩形保持倾斜;5–8 边形能认出并自动变成正多边形。
  • 荧光笔:画得差不多直会自动变成直线(可关闭)。
  • 导航:抓手工具(电脑按 H);所有工具和页面操作都能设快捷键;点页码跳转;PDF 书签目录;在最后一页继续往下拉添加页面。
  • 设置页:分成新建笔记、书写、图片文档和嵌入三组,识别与 AI、高级折叠起来,全部中文;没有删除任何设置。
  • 兼容性:白板和新的曲线形状使用文件格式 7,0.10 及更早版本只读打开;新写的字多存一份墨迹,文件约大 1.6–1.9 倍,旧版本仍能打开编辑。

SHA-256

9484ba83e69013584454202a122f94bf7b73e85458fe8a681925da250891e3b8  main.js
2008a53c039e36411789ee0a94db029d6dc473ee7dcb203864135f397b85606c  manifest.json
0537a163123c0b39bd7e2e4b5bc0e069ce6f0c09ff29290f7d7dfafdc5cf000a  styles.css

0.9.1 (public edition)

Choose a tag to compare

@github-actions github-actions released this 01 Nov 14:49

HandNote 0.9.1

Fix for pen tablets on the desktop. Notes, writing on the iPad and recognition are unchanged.

  • Space + pen drag pans the page. With a pen tablet (Wacom, Huion, XP-Pen…), holding Space and
    dragging with the pen moved nothing and drew a stroke instead; only the mouse could pan this way.
    The pen now pans like the mouse, on notebook pages and on imported documents. Without Space the
    pen writes as before.
  • Pen side button as middle button pans. If the tablet driver maps a pen button to the middle
    mouse button, holding it and dragging pans the page, so the keyboard is not needed.
  • A pan that ends outside the page area now ends cleanly.
  • The plugin description in the directory now mentions document annotation.

修复电脑上的数位板:按住空格用笔拖动,以前会写字而不是移动页面(只有鼠标可以),现在笔和鼠标一样可以移动页面,导入的文档也一样;不按空格时照常书写。在数位板驱动里把笔的侧键设成「中键」后,按住侧键拖动也能移动页面。笔记、iPad 上的书写和识别都没有变化。


SHA-256

32017b250588fbe87486a31531541d6fd5d0c866fcb024a0f42457b9b2ccf8d9  main.js
4b6303b4d6726fda3d39a00920e175528dc9766e818a0c4003a8082687b8d5f4  manifest.json
0f1f25ea2b32e318cc787b8bb8058105a558277ddd75237448bcc21a8608d8b2  styles.css

0.9.0 (public edition)

Choose a tag to compare

@github-actions github-actions released this 23 Oct 13:09

HandNote 0.9.0

Annotate documents by hand, and a finger long-press menu for pasting.

Import documents to annotate — the Import document… command (also in the editor menu), or
right-click a PDF, Word, PowerPoint or Excel file in the file list → Annotate in HandNote. Each page of the document becomes a
HandNote page of the same size; you write on it like on any other page.

  • PDF — rendered on demand by the PDF engine that ships with Obsidian.
  • Word (.docx and older .doc) — laid out once into fixed pages: headings, paragraphs and their
    styles, lists, tables (column widths, merged cells, borders), pictures, landscape sections. Page
    breaks are close to Word's but not identical. Headers / footers, footnotes, text boxes, charts and
    equations are not shown; the import says which ones a file has. For .doc, pictures and list
    numbering are not shown yet.
  • PowerPoint (.pptx) — one page per slide: background, master and layout shapes, placeholders,
    bullets, preset shapes, pictures (cropped, rotated), groups and tables. Animations, charts,
    SmartArt, video and shadow effects are not shown.
  • Excel (.xlsx) — printed onto A4 pages like OneNote (landscape when a sheet is wide), cells at
    their real size from the top-left corner, with headings, gridlines, fills, borders, merged cells,
    fonts, wrapping, number formats and pictures. Formulas show the result saved in the file;
    HandNote does not recalculate.
    Hidden rows, columns and sheets are skipped; charts and
    conditional formatting are not shown.
  • Pick several files at once on the iPad: they are imported in the order you chose them.
  • Older .ppt / .xls, Pages / Keynote / Numbers, OpenDocument and password-protected files are
    refused with the reason and what to do (for example "save as .pptx or PDF").

Your files stay yours. The original document is kept as a separate file in your vault (folder
HandNote imports, configurable in Settings → Imported documents) and is never modified; importing
the same file again does not copy it twice. The note stores only a reference and your ink. Word,
PowerPoint and Excel files get a small layout file beside them (<name>.handnote-layout.json, or
.json.gz when large) so every device shows exactly the same pages — make sure your sync tool syncs
it; if it is missing HandNote lays the file out again. Renamed or moved originals are followed; if
one is deleted, your annotations stay. Macros never run, remote images and links are not loaded,
and nothing is uploaded: everything happens on your device.

Finger long-press menu. Hold a finger on the page for about half a second: Paste (what you
copied in HandNote), Paste from clipboard (text or a picture from another app), Text box here,
Insert image here. The Apple Pencil is not affected. On desktop, right-click opens the same menu
and Ctrl+V pastes. iPadOS shows its own "Paste" confirmation when a note reads the clipboard.

Compatibility. Notes that contain imported pages are saved as format 6; HandNote 0.8.x opens
them read-only. Update HandNote on every device that edits them. Notes without imported pages are
saved exactly as before. On-device text recognition and model packs are unchanged; this edition
still has no on-device math recognition.

main.js is about 6.2 MB (the recognition runtime is built in). Obsidian Sync's Standard plan does
not sync files over 5 MB — install HandNote on each device from Community plugins in that case.


导入文档批注:「导入文档…」命令(编辑器菜单里也有),或在文件列表里对 PDF / Word / PowerPoint / Excel 文件右键 →「在 HandNote 中批注」。文档的每一页变成同样大小的 HandNote 页面,可以直接书写。支持 PDF(用 Obsidian 自带的 PDF 引擎渲染)、Word(.docx 和旧版 .doc)、PowerPoint(.pptx)、Excel(.xlsx,像 OneNote 一样印在 A4 纸上;公式显示文件中保存的结果,不重新计算)。iPad 上可以一次选多个文件,按选择顺序导入。不支持的格式会说明原因和办法。原文件单独保存在仓库的 HandNote imports 文件夹(可在设置中修改),不会被修改,也不会重复保存;Word / PowerPoint / Excel 旁边会有一个排版文件,保证各设备页面一致,请让同步工具同步它。不运行宏,不加载远程内容,不上传任何文件。

手指长按菜单:手指长按页面约半秒,可以粘贴、从剪贴板粘贴、添加文本框、插入图片;Apple Pencil 不受影响。桌面版右键打开同一菜单,Ctrl+V 粘贴。

兼容性:含导入页面的笔记以格式 6 保存,0.8.x 只能只读打开,请在所有编辑这些笔记的设备上更新。其他笔记格式不变。本机文字识别不变;此版本仍不含本机公式识别。main.js 约 6.2 MB,Obsidian Sync 标准版不同步超过 5 MB 的文件,请在每台设备上安装插件。


SHA-256

3a3649035876e59d0400bd0d99d81eac4455ddadb94a30b7f5e2b9e5cc87428f  main.js
785b658eb52d5d2f70cd848cab315b8bd1a7884c712e2f0a70a480cff834082e  manifest.json
0f1f25ea2b32e318cc787b8bb8058105a558277ddd75237448bcc21a8608d8b2  styles.css

0.8.1 (public edition)

Choose a tag to compare

@github-actions github-actions released this 22 Oct 13:24

HandNote 0.8.1

Maintenance release after the first community-directory scan. No change to writing, notes or
recognition results.

  • On-device recognition runs only in a Web Worker; the in-page fallback, which injected a module
    script, is removed (no device we test on ever needed it).
  • The bundled Chinese stroke data no longer carries a blanket eslint-disable comment.
  • The interface language follows Obsidian's getLanguage().
  • Releases carry build-provenance attestations; checksums are listed in the release notes instead of
    an extra file.
  • README / FAQ: main.js is about 5.9 MB (built-in runtime), above the 5 MB file limit of Obsidian
    Sync's Standard plan — install HandNote on each device in that case.

维护版本,处理社区目录首次扫描的意见;书写、笔记和识别结果没有变化。本机识别只在 Web Worker 中运行(去掉了向页面注入脚本的备用方式);界面语言改用 Obsidian 的 getLanguage();Release 附带构建来源证明(attestation)。main.js 约 5.9 MB,Obsidian Sync 标准版不同步超过 5 MB 的文件,请在每台设备上安装插件。


SHA-256

f5a89b0a469fd1f979d639c9a2a6043dbf1e006c78c973bd233a06029bd8e51c  main.js
19822222dd61d0a814655e948021774495d4bcd76e2fa6a30266fe9de061b727  manifest.json
87a8b035b7b7ee1098d98618053d3f677ec85a57f7517230815e904194e1607d  styles.css

0.8.0 (public edition)

Choose a tag to compare

@github-actions github-actions released this 22 Oct 12:26

HandNote 0.8.0

First public release of HandNote: handwritten notebook pages for Obsidian, made for the Apple
Pencil and working with touch and mouse.

  • Notebook pages in .handnote files: paper sizes and patterns, many pages per note, a page
    sidebar, embeds in Markdown (![[Note.handnote]]).
  • Pens with Apple Pencil pressure, highlighter, shape pen, laser pointer; precise, partial or
    whole-stroke eraser; text boxes, images, shapes and connectors, formulas (LaTeX), mind maps.
  • Lasso: move, resize, rotate, copy, recolour, group; a loop around part of a converted text
    picks just those characters.
  • Convert handwriting to text on your device (Chinese and English, PaddleOCR PP-OCRv5): in
    place, one undo step, with candidates and "Restore ink". The recognition runtime (ONNX Runtime
    Web) is built into the plugin; the models (15.8 MB Chinese, 7.5 MB English) are downloaded only
    when you ask, checked by SHA-256, kept on the device and work offline. Nothing is uploaded.
  • Formulas: type LaTeX with a live preview (Convert → Math opens the editor), or recognise
    handwritten math with MyScript using your own keys. This version has no on-device math model.
  • Optional services with your own keys: MyScript; AI providers for mind maps, flowcharts and
    picture text — always after a confirmation.
  • Safe storage: sync-conflict detection, recovery journal, backups; damaged or newer-format
    notes open read-only.

Requirements: Obsidian 1.11.4 or newer. On-device recognition on iPad / iPhone needs iPadOS / iOS
16.4 or newer. Network use and privacy: see README and PRIVACY.md.


HandNote 0.8.0 是第一个公开版本:为 Apple Pencil 设计的 Obsidian 手写笔记插件。文字识别(中文、英文)在本机运行,模型按需下载、可离线使用、不上传任何内容;公式可用 LaTeX 输入,或用你自己的 MyScript 密钥识别。本版本不包含本机公式识别模型。