Repository navigation
Releases
0.30.0
Eight roadmap features: coloured sections in a notebook (#52), a computable table (#147), a trend line on line charts that completes #295, numbered markers on a figure (#247), tidy hand-drawn flowcharts (#245), a timeline element (#148), link suggestions while creating a Zettelkasten card (Z5) and card sequences with branches (Z7). The notebook format moves to version 28 (sections): the migration from version 27 is automatic, and Notebook 0.29 and older open a v28 notebook read-only and never overwrite it. Every save on 0.30 writes version 28, so update every synced device together. The review fixes of each feature are listed under it.
Zettelkasten: link suggestions (Z5)
- Link suggestions while creating a card (Z5). The New card dialog (also from the Inbox) has a Cards to link field: as you type the title, source and tags, the cards of your slip-box that share tags or title words with it are listed (best first, the most recently changed card breaks ties), each with the reason. Tap one to link it; the link is written both ways, like a drawn arrow, once the note exists. Settings > Study > Zettelkasten: Suggest cards to link (on by default) and Suggestions shown (1 to 8).
- Cheap. The candidates come from the cards already indexed and the metadata cache (no note is read), are capped at the 600 most recent cards, and ranking runs a quarter of a second after the last key.
- No format change. Code: pure
src/zettel/link-suggest.ts,src/zettel/link-suggest-ui.ts. Teststests/zettel-link-suggest.test.ts; harnessdoc=linksuggest. Not verified on Android hardware. - Review fix: the chosen cards are linked to the exact note the dialog made. The first version waited up to 30 seconds for "the next new card" and could write the links into another card (one arriving by sync, a slip-box card made meanwhile, a creation that never happened). That watcher is gone. The cards chosen travel with the dialog's answer (
CardAnswer.links, never written to the note's properties) and are linked inside the same queued task right after the note is written, in the card dialog and in the Inbox. If the card is not made, nothing is linked. A chosen card that was renamed meanwhile is found again by its id. The notice says what happened: Linked to 1 card. / Linked to N cards. (Italian singular and plural), The chosen cards were already linked. when nothing was added, and the failure notice when a link could not be written. Chosen cards deleted while the dialog was open are named as gone (1 of the chosen cards is gone… / N of the chosen cards are gone…), never as "already linked" (review R6). Nothing keeps listening after the plugin is unloaded.
Sections inside a notebook (#52, document format 28)
- Coloured sections inside a notebook (#52), as in OneNote. New section… (page sheet, All actions, command) starts a section at a page with a title and one of the eight subject colours; it runs to the page before the next section. The page navigator shows a coloured tab strip (the section in view is current; a tap jumps to its first page), a divider with the title and page count before each section, and a colour edge on its pages. The Sections dialog lists them (tap to go; rename, recolour, delete from the row's menu). Next section and Previous section jump between them. Every change is one undo step, named in the history panel. Read-only notebooks show and navigate sections but do not change them. Sections whose page is gone show nowhere but count toward the 200: the Sections dialog says how many and offers to remove them, and New section uses the same count (review S4); the New section dialog remembers the page itself, not its position, so a page list that changes while it is open cannot move the new section (review S6).
- Sections stay consistent with the pages. Sections are anchored to page ids. Deleting the first page of a section moves the section to the next page (or removes it if that page starts a section of its own); moving pages keeps a section with its pages, or starts it at the first page that stayed, and never changes the section of a page that did not move: a section moved into the middle of another splits it, the pages after it keep the host's title and colour (a continuation section), and the two parts become one again when the block moves out; only pieces of one split section are joined (a continuation is recognised by its id, also through a chain of splits and after a rename and a rename back, review T2), never independent sections that share a title and colour, such as a weekly "Lecture" and "Homework" (review S1, R1; pages in no section that a moved section lands in front of join it, the only way they can show); adding, inserting and duplicating pages change nothing. Undo puts pages and sections back exactly. Known limits (labels only, nothing is lost): the pieces of a split section copied by a notebook template stay separate sections, and when two devices split one section offline, a conflicted-copy merge keeps one piece and reports the other as differing (review T3, T4).
- Copies, merges, templates. A conflicted copy's merge adds the copy's sections the notebook lacks (counted in the summary); the summary also says how many of the copy's sections differ (renamed, recoloured, moved, or another one on a page where the notebook already starts one: the notebook's are kept, the copy's stay in the copy) and how many did not fit a full list (the copy then stays where it is), so a copy whose only change is a section is never "Nothing new" (review S2, S8); notebook templates keep the sections; pages copied or moved to another notebook take none; repair salvages them.
- Document format v28. One optional notebook-level list,
sections(id,title1–60 characters,color,page; at most 200; no two on one page). Migration 27 → 28 is the identity plus the version; older plugins open a v28 notebook read-only. Unknown keys inside a section are not written back and are counted as dropped on read, so a backup is kept before the save that loses them; format.md now says the plugin does not keep unknown fields (review S3). Every save on 0.30 writes version 28, even a notebook without sections, so a device still on 0.29 opens it read-only (with a backup, nothing is lost): update every synced device together (review S9). JSON Schemadocs/schema/notebook-v28.schema.json(renamed from v27). - Code.
src/model/sections.ts(rules,SetSections),src/view/sections-tools.ts,src/view/sections-modal.ts,src/view/sections-logic.ts. English and Italian texts, long-press help, context ranking. Teststests/model-v28.test.ts,tests/sections-logic.test.ts; harnessdoc=sections. Not verified on Android hardware.
Computable table (#147)
- Computable table (#147). With a hand-drawn table selected, Compute table (All actions, command palette) works out the formulas typed in the cells and writes each result after its formula, as ONE undo step. A formula is a text box inside a cell that starts with
=:=SUM(B1:B4),=AVG(B1:B4),=A2*B2,=C2*15%,=MIN,=MAX,=COUNT,=MEDIAN,=PRODUCT,=ABS,=SQRT,=ROUND(x, 2),=PCT(part, whole), with+ - * / ^, parentheses, ranges and a postfix%(Italian names such asSOMMAandMEDIAwork too; arguments are separated by,or;).A1is the top-left cell of the table, header row included. After computing, the box reads=SUM(B1:B4) → 100: the formula stays in the box (Compute only ever replaces the result it wrote: a value right after the arrow that ends its line or meets a second arrow, or an error code; anything else after the arrow, such as=B2*C2 → 120 (checked by hand)or a number you typed after your own arrow, is kept behind the new result and a second arrow, and a note on a line below the formula and the box's line breaks all stay; a blank or text value shows-; a line below that starts with an operator, such as-D2,+ B3or* 2, continues the formula, so a mistake there shows an error rather than the value of the lines above, while a bullet note such as- includes VATor* see p. 4(an operator, a blank and a plain word) stays a note: review R2, R3, T1; words typed after a computed result on its own line are kept behind the next result, which leaves the old value visible once, so write notes on the line below or after a second arrow, as the long-press help says: review T5), so editing a number and choosing Compute table again updates the result. Errors are shown as codes:#REF(a cell outside the table),#CYCLE(cells that depend on each other),#DIV/0,#VALUE(text where a number is needed),#NAME(unknown function),#NUM,#ERR(the formula does not read), and every formula that uses an error cell shows it too. Refused, with a notice and nothing changed, when a formula box is locked, part of a drawing with states or under a study tape, and fail-closed when the table or a box to be written touches a redaction box (a result could reveal what is under it). Handwriting is not read: numbers and formulas are typed in text boxes. Charts and statistics skip a formula cell (its text is not a plain number). No format change. Code:src/math/table-formula.ts,src/ink/table-compute.ts,TableTools.computeinsrc/view/table-tools.ts.
Chart trend line (#295)
- Trend line on line charts (completes #295). The Chart from table dialog has a Trend line choice for the Line type: a dashed least-squares line through the first series (x is the row position 1, 2, 3 ...) with its equation and R² as a small label inside the chart. The choice is kept by Update chart (stored as a trailing
rin the chart group id; ids made by 0.29 read as before; no document format change). Code:src/math/chart-regression.ts.
Numbered figure markers (#247)
- Numbered markers on a figure, with a legend (#247). Select a picture, a drawing (ink) or ...
0.29.0
Seven roadmap features: study tape (#10), charts from table data (#244), figure captions and numbering (#248), an advanced calculator (#182), strike-through as logical deletion (#96), Zettelkasten card templates (Z9) and Zettelkasten hygiene (Z10), plus table statistics (part of #295, still partial: no chart regression line) and redaction hardening for undo and redo, page geometry and merges. The notebook format moves to version 27 (study tape): the migration from version 26 is automatic, and Notebook 0.28 and older open a v27 notebook read-only and never overwrite it. Four review rounds are folded in (see Review fixes).
studytape
- Study tape (#10) and document format 27. Study tape (All actions, command palette) turns on a mode where a drag with the pen, the mouse or a drawing finger lays an opaque strip over part of the page (one undo step), in the colour chosen in Settings > Study > Study tape colour (mint, sky, rose, sand or slate). Tap a tape to reveal what it covers (only a faint tint and a dashed outline stay), tap again to cover it. This works with the mode off too: with the pen, with a finger that pans, and on a read-only notebook.
- Reveal is for this screen only. Whether a tape is revealed is never saved, synced or undone: every tape is covered again when the notebook opens. Reveal all study tapes and Hide all study tapes act on every tape of the notebook.
- Nothing hides behind a tape by accident. A pen stroke that starts on a hidden tape writes nothing; the erasers leave the ink and objects a hidden tape covers alone (see Review fixes). Tapes select, move, resize, turn a quarter turn, group, lock and delete like other elements; a locked page takes no new tape but its tapes still reveal.
- Exports. PDF, PNG, SVG, interactive HTML, thumbnails and Copy as image draw every tape covering, as the notebook opens. A clean copy and Hand in leave the tapes out. Redaction cuts a tape around a black box, so nothing redacted can show and the box is never under a tape.
- Document format v27. One more element type,
tape(x,y,width,height4 to 20000 pt,color; the usualgroup/locked/lockAt). Migration 26 → 27 is the identity plus the version (a v26 file holding a tape is refused, like any element type before its version); older plugins open a v27 notebook read-only. JSON Schemadocs/schema/notebook-v27.schema.json. - Code.
src/model/tape.ts(geometry, reveal state),src/ink/tape-render.ts(look),src/ink/tape-guard.ts(what the erasers leave alone),src/view/tape-tools.ts(the mode and the taps). Teststests/model-v27.test.ts; harnessdoc=studytape.
figcaptions
- Figure captions and references that update themselves (#248). Select a picture (or a figure cut-out) and choose Caption figure… in All actions: a text box under it reads "Fig. 3 — your words". Numbers follow the reading order of the whole notebook (page order, then top to bottom, left to right) and renumber at once when a captioned figure is added, removed or moved, or pages are reordered. Figure reference… puts a "Fig. 3" text box on the page that always shows the figure's current number; tapping it (finger tap, Ctrl/Cmd+click or Open link) goes to the figure. A reference to a deleted figure (or one that lost its caption) reads "Fig. ?", dimmed and dashed. The Figures gallery shows each captioned figure's number and offers Caption… and Insert reference on its card.
- No format change. A caption is a text box starting with
{{figcap:<picture id>}}, a reference holds{{figref:<picture id>}}; the number is resolved when the text is shown (like a wikilink's label) on the page, in thumbnails, in the PDF, SVG, PNG and print exports, the Markdown export, the companion note and the API's PDF. The stored text never changes. It uses the existing add and replace commands, so history, per-page undo and the history panel need nothing new. - Code.
src/ink/figure-text.ts(markers and the registry of number sources),src/model/figure-captions.ts(pure numbering and the boxes the actions build),src/view/figure-captions.ts(the cached numbers of an open notebook, the caption dialog and the picker);shownTextinsrc/ink/wikilink.tsis the single place that resolves markers. English and Italian texts, long-press help, context ranking. Teststests/figure-captions.test.ts; harnessdoc=figcaptions. Not verified on Android hardware.
strikedelete
- Strike-through as logical deletion (#96). A roughly horizontal line drawn through the middle of a handwritten word marks that word as deleted. By default nothing changes: the word stays on the page, readable and struck through. Hide struck words (Settings > Reading, the All actions sheet, the command palette) hides the struck words and their lines in the view; switch it off and they are back.
- Nothing is stored, nothing is deleted. The struck state is derived from the geometry of the ink every time (no change to the document format): undo of the line un-strikes the word, erasing the line brings the word back. A line under or over a word, the bar of a t or an A, a hyphen, a diagonal, a scribble and a line across a different line of text do not count; a long line over several words of one line strikes them all; a crossed-out single letter counts. Highlighter, marker, shape and invisible ink are never strike lines.
- Hidden means out of reach, not erased. While hidden, struck ink is not drawn and the eraser, the lasso and the other ink tools skip it, so touching empty paper never deletes it. It is still in the file, in undo and in the page counts.
- Exports. Leave out struck-out words in the export dialog (off by default, with or without Clean copy; the setting Leave out struck-out words from exports decides where it starts, and the share sheet follows the setting) goes through the clean export filter, so PDF, SVG, HTML, PNG images and print all honour it. The notebook is not changed.
- Cheap. Detection runs only while the setting is on, a moment after a change, one page per idle slice and never while the pen writes; the renderer only reads a per-page cache. A page without a long straight stroke costs one pass over its points. Searches and the heading index do not ignore struck words yet.
- Code. Pure
src/ink/strikethrough.ts(reads strokes withsegmentText,StrikeCache),src/view/strike-hide.ts,CleanExportOptions.struck,Renderer.setStruckInk, settingshideStruckandexportHideStruck, the actiontoggle-hide-struck. 19 new unit tests; harnessdoc=strikedelete.
charts
- Charts from table data (#244). Select a hand-drawn table (alone, or together with the text boxes in its cells) and choose Chart from table in All actions (or the command Chart: make from the selected table). The dialog asks for bars, a line or a pie, an optional title, the first colour of the palette and the size, shows a picture of the chart and what it read, and draws the chart beside the table (below it, else to the right, else above) as ONE undo step. A chart is ordinary content: vector shape strokes (frame, grid lines, filled bars and wedges, lines, dots) and text boxes (title, axis labels, legend) of one group, so every render and export path draws it, and it moves, resizes, restyles, copies and erases like any group. No change to the document format.
- What is read. The first column names the rows, every other column is a series (bars and lines: up to eight; a pie: the first one); the first row is the names of the series when none of its cells is a number. Cells are the text boxes (and typeset equations that are just a number) whose anchor lies in a cell. Handwriting is not read: the plugin has no handwriting recognition, so the numbers are typed in text boxes. A decimal comma, thousands separators, a minus sign, percent and currency signs are understood; empty and non-numeric cells are left out (and counted in the dialog); a pie ignores zero and negative values and joins the smallest slices beyond twelve.
- Update chart. With a chart selected, Update chart reads its table again and redraws the chart in the same place, in ONE undo step, keeping the type, the colour, the position and size and an edited title. It says so when nothing changed, and is refused (with a reason) on a locked page, for locked or drawing-state parts, when the table is gone or holds no numbers. The link to the table is the chart's group id (
nbc1.<type><colour><titled>.<table group>.<random>, read leniently), so nothing is stored outside the page; a copied chart gets a fresh group id and is a plain picture. The update is explicit, not automatic. - Code.
src/math/chart-layout.ts(number parsing, data from cells, axis ticks, pie slices, layout; pure),src/ink/table-data.ts(text in the cells of a table),src/ink/chart.ts(strokes and text boxes, group id, insert and update plans),src/view/chart-dialog.ts,chart-logic.ts,chart-tools.ts. Only existing History commands are used (oneBatchper step), so nothing new to classify for per-page undo. Tests:tests/chart-layout.test.ts,tests/chart.test.ts,tests/chart-actions.test.ts; harnessdoc=charts.
stats
- Statistics from a table (#295). With a hand-drawn table selected, Table statistics (All actions) opens a card with the count, mean, median, standard deviation, minimum, maximum and sum of a column and, with a second column chosen, the fitted line (slope, intercept, R squared). Insert as text adds a text box beside the table (or under it when the page is narrow) as one undo step; Copy puts the same text on the clipboard. Numbers are read from the text boxes written in the cells (decimal point or comma, a header row is recognised); cells that are not numbers are skipped and counted, handwriting is not read. No format change. Code:
src/math/stats.ts,src/ink/table-numbers.ts, `src/ink/table-r...
0.28.0
Eight features: rotate and crop PDF pages (#76), per-page undo (#98, a setting, off by default), hand-drawn tables (#41), a paint bucket (#184), a line handle to reorder lines (#256), a live lecture mode (#132), numbered boxes with an index (#205) and actions suggested by the selection's geometry (#403). The notebook format moves to version 26 (PDF page rotation and crop): the migration from version 25 is automatic, and Notebook 0.27 and older open a v26 notebook read-only and never overwrite it. Three review rounds are folded in (see Review fixes).
pdfrotate
- Rotate and crop imported PDF pages (#76) and document format 26. The page sheet (and All actions) has Rotate PDF page right, Rotate PDF page left and Crop PDF page… for pages that show a PDF. The crop dialog shows the whole page with a frame (finger, S Pen or mouse drag on the corners, edges or inside; arrow keys on a focused handle), turn buttons, Whole page to reset, and, for a PDF with several pages in the notebook, All N pages of this PDF. One edit is one undo step (PDF page rotated / PDF page cropped in the history panel, in English and Italian).
- Nothing moves on the PDF. The ink, highlights, areas, pictures, boxes, comment regions and the pivots and poses of states are carried with the page by a quarter turn and a shift (strokes and areas turn exactly; pictures turn; text boxes, equations, graphs, sticky notes and checkboxes keep their orientation and size and only their centre goes where it would go, with the ink written on them). Locked pages refuse the change; hidden ink, groups, locked elements and page times are respected.
- Nothing is lost or clipped. Ink that would end up beyond the left, right or bottom edge of the new page makes the page margins grow just enough to hold it, so it stays visible and editable beside the PDF. Ink that would end up above the top edge (a page has no top margin) stops the change for that page, with a notice; nothing is changed. Comment regions are kept inside the page.
- Every page, every output. The canvas, thumbnails, the zoomed-out levels, PDF text search, selection, links and the text-following highlighter, annotation and digest exports, the PDF, PNG, SVG and interactive HTML exports (the PDF re-embeds the turned, cropped picture), hand-in, presentation, the reference window and the hover preview all draw the same page. The view-only Crop PDF margins option still works, on top of a stored crop (it fits the white margins inside it).
- Document format v26. Two optional fields on a PDF page background:
rotate(90, 180 or 270, clockwise, on top of the PDF's own rotation) andcrop(x,y,width,heightin PDF points of the upright page, applied before the turn). The v25 to v26 migration is the identity apart from the version; invalid values are dropped and counted when reading and refused when writing; a v26 notebook opens read-only in 0.27. Schemadocs/schema/notebook-v26.schema.json, documented indocs/format.md. - Code.
src/model/pdf-view.ts(geometry and plan),pdf-view-format.ts(the file form),pdf-view-command.ts(SetPdfView),pdf-view-ops.ts(this page or all),src/view/pdf-view-actions.tsandpdf-crop-logic.ts(the actions and the dialog),PdfStore.render(asset, page, scale, view),boxesOnPage/pageToPdf/pdfRectToPagewith a view.
pageundo
- Per-page undo (#98). A new switch, Undo on this page only (Settings > Pages, off by default), makes Undo and Redo act on the page in view (in a two-page spread, the page you touched last): the latest change made on that page is taken back even if you wrote on other pages since, and the other pages are never touched. The toolbar buttons then read Undo on this page / Redo on this page (tooltip and long-press help). With the switch off nothing changes.
- One history, not several. The notebook still keeps ONE history; each step knows which pages it touched. Undo on a page takes the newest step that touches that page out of the middle of the history and runs the step's own inverse (never a snapshot), so later edits of other pages are never dropped. It is safe because no later step touches that page. A step that touched several pages (moving ink between pages, copies to a page), the page list (add, delete, move, reorder, insert) or the whole notebook (properties, saved views, files) is global: it is never undone out of order, and a notice says so and points to the history panel.
- Redo. An undone step stays redoable while you write on other pages; a new edit on the same page (or any global change) drops it, as a new edit always does. Redo on a page brings back the step that page undid last. The guards are the ones of an ordinary Undo: locked pages, the document check (a step that would make the notebook unsavable is refused), groups (a macro run is one step) and the read-only mode.
- History panel. With the switch on, the panel marks the steps of the page in view ("this page") and the steps that touch the whole notebook ("whole notebook") and says so; the list, the order and the jumps stay global.
- Code.
src/model/page-undo.ts(which pages a step touches,pageRules),src/model/page-scope.ts(types and pure rules the History needs),History.undoOnPage/redoOnPage/peekOnPage/setPageRules/setPagewiseinsrc/model/history.ts; no format change. Tests:tests/page-undo.test.ts,tests/page-undo-review.test.ts,tests/page-undo-r2.test.ts,tests/page-undo-panel.test.ts; harness scenariodoc=pageundo.
linehandle
- Line handle (#256). Reorder lines (page menu, All actions, command palette) shows a small handle at the left of every handwritten line of the page in view. Drag a handle and the whole line moves between the other lines; the lines in between shift up or down by the moved line's height, so the spacing is kept. Up and down buttons in a small bar (and the arrow keys on a focused handle) do the same one place at a time. A handle that is only tapped chooses its line.
- What moves. The line's line-pen handwriting (pen, fountain pen, brush), its invisible ink, and every element wholly inside the line's strip (an area highlighter behind it, a text box, checkbox or picture at its end, a sticky note with the ink it keeps hidden, a graph with its bound ink) move together, as rigid translations (same points, pressure, width, taper, id and layer). One undo step per drop (
UpdateItems, titled Line moved in the history panel); the page times and the document format do not change. - What refuses. A locked element on the line, a group that reaches beyond the line, a shape, drawing or highlighter stroke across it, an item that two lines would both move, a locked page, a read-only notebook, a line that would land on something that stays put or outside the page: the handle is dimmed, and the message says why. Nothing is moved on a refusal.
- Code. Pure planner
src/ink/line-reorder.ts(reusesanalyseBaselineand the line joining oftidy.ts), the handles layersrc/view/line-handles.ts(DOM over the canvas, no change to the pointer controller or the input policy), registry actionpage-reorder-lines. English and Italian texts, long-press help, context ranking. Teststests/line-reorder.test.ts; harnessdoc=linehandle. Not verified on Android hardware.
tables
- Hand-drawn tables (#41). Table in the insert sheet asks for rows, columns, cell size, line width, line style, colour and a thicker line under the first row, then draws the grid at the centre of the view: straight shape lines of one group, one undo step, exported like any shape (taper never applies). With the table selected the All actions sheet offers Add row, Add column, Remove last row, Remove last column and Even out cells, each one undo step (fresh lines, same group; a locked page refuses them). A row or column insert moves the ink that lies fully inside the table beyond the new line by the cell size (only ungrouped, visible ink); the other edits leave ink where it is. Snap now also pulls to the row and column lines of a table. No format change: a table is recognised again from its lines.
- Code.
src/ink/table.ts(geometry, detection, snap lines),src/ink/table-edit.ts(History commands),src/view/table-dialog.ts,src/view/table-tools.ts; teststests/table.test.ts; harnessdoc=tables. Not verified on Android hardware.
bucket
- Paint bucket (#184). A Paint bucket button at the end of the colour row (pen, highlighter and shape options; also a command and in the All actions sheet): tap it, then tap inside an area closed by ink and the area is filled with the colour in use, behind your lines. A light tint by default (Settings, Writing: Paint bucket fills as a tint; off = solid), with the pen's opacity. Gaps of about a pen width in the outline are closed; an outline that is not closed, a tap on a line, a tiny pocket, an area as large as the page or a page with too much ink gives one clear notice and adds nothing. One undo step ("Area filled"). The mode ends with each fill, like the eyedropper.
- Stays vector, no format change. The ink of the page is drawn into a low-resolution mask (2 to 4 cells per pt, at most 2 million cells; a window around the tap on a huge page), the area under the tap is flooded against a time budget, and its outline is traced and simplified to a polygon of at most 400 corners in page coordinates (then resampled every 3 pt like any shape). That polygon is stored as an ordinary filled shape stroke (format 22
fill,fillTint, format 24opacity) with a hairline, placed after the earlier fills and before all the ink, so every renderer and export already draws it under the lines. Known limit: the fill is one polygon without holes, so a closed shape inside the area is coloured inside too (tap it to give it its own colour). - Code.
src/ink/paint-bucket.ts(pure: mas...
0.27.0
Eight features: stroke taper for the pens, two pages side by side, headings when zoomed out, macros, a layout that follows the input device, workspace presets, suggested search terms for PDFs and tasks due on planner pages. The notebook format moves to version 25 (taper): the migration from version 24 is automatic, and Notebook 0.26 and older open a v25 notebook read-only and never overwrite it. Three review rounds are folded in (see Review fixes).
Stroke taper and document format 25
- Stroke taper (#351) and document format 25. A Taper row in the pen options (the pen, the fountain pen and the brush) with two sliders, Start and End, and a small picture of the stroke drawn by the engine: the line thins towards the first and the last point, like the flick of a pen. It applies to what you write next; Off (the default) is exactly the look of every earlier version. The marker, the highlighter and shapes keep their flat ends.
- How it is measured. The taper is a length in line widths (1 = twelve widths, never more than half the stroke), so the same setting looks the same on a fine and on a broad pen and survives scaling; a short stroke becomes a leaf shape and a dot stays a dot. The start thins from the first sample (the wet ink shows it); the end settles into its point when the pen lifts.
- Everywhere you see the page. The static canvas, the live fallback, the zoomed-out level of detail and thumbnails, PNG, SVG, PDF and interactive HTML build the stroke with the same geometry. Favourite pens, pen sets, the radial menu's active mark and the style eyedropper keep the taper. A cut by the eraser or a redaction box keeps a taper only on the piece that still reaches that end of the stroke; joining broken strokes keeps the first start and the last end; a stroke turned into a shape loses it.
- Document format v25. Two more optional numbers,
taperStartandtaperEnd(0.05 to 1), on a pen, fountain pen or brush stroke (render 2), written only when set. The v24 to v25 migration is the identity plus the version (a stray key of a v24 file is dropped), so large v24 files are staged too; read leniently a value outside the range, one that is not a number or one on a stroke that cannot taper is dropped and counted (the stroke stays); the strict write refuses all of them. Older versions open a v25 notebook read-only. The golden render hashes do not move. Schemadocs/schema/notebook-v25.schema.json(renamed from v24),docs/format.md,docs/architecture.md. - Code.
src/model/taper.ts(limits and helpers,strokeTaper),InkBuilderinsrc/ink/ink-geometry.ts(start taper in the point radii, end taper atfinish()),src/view/taper-row.ts(the row),FavouritePen.taperStart/taperEnd,ToolbarState.penTaperStart/penTaperEnd. - Tests.
tests/model-v25.test.ts(helpers, fields, migration, lenient read, staged loading, repair, merge, copies, engine geometry, every export path, cuts and joins, pens),tests/format-schema.test.ts(schema v25); harnessdoc=taper(dev/harness/taper-check.ts). Not verified on Android hardware.
Layout by input device
- Layout by input device (#431). The notebook view now shapes itself to what you are using: with the pen the compact bar as before; with a finger one toolbar size more (larger touch targets) and more room between buttons; with a mouse and keyboard a clearer hover and focus state, and the tooltip of a bar button shows the keyboard shortcut you assigned to it in Obsidian. Settings > Appearance > Adapt layout to input: Automatic (default), Pen, Finger, Mouse and keyboard. Automatic reads the pointer type of events the view already gets: three consistent events switch, never in the middle of a stroke, and a touch right after the pen (a resting palm) is ignored. No format change.
- Code. Pure, tested
src/ui/input-layout.ts; DOM gluesrc/view/input-layout-view.ts(a passive capture listener, one class on the view root); tests intests/input-layout.test.ts; harness scenariodoc=inputlayout.
Two pages side by side
- Two pages side by side (#49). A third way to scroll, next to Continuous and One page at a time: the pages are shown in pairs like an open book and scroll pair by pair. Turn it on from the page sheet (Two pages side by side), the command palette, or Settings > Pages > Scrolling. You write on both pages; every stroke belongs to the page the pen started on and never spills onto the other one (the existing page hit test routes it, the stroke pipeline and the pen controllers are untouched).
- Book or pairs. First page alone, like a book (on by default): page 1 sits alone on the right and the pairs are 2-3, 4-5... Off, the pairs are 1-2, 3-4... An odd last page sits alone on the left. Pages of different sizes (portrait next to landscape, PDF pages) are aligned by their top edge with a gap, and the binding stays on one vertical line.
- Only where there is room. A spread needs a view at least 720 px wide and not taller than wide; a phone or a portrait pane shows one column as before (the setting stays, the button is not offered). Two pages on a landscape tablet (off by default) turns the spread on by itself in landscape and off in portrait, staying on the page in view.
- Everything that finds a page follows. Next/previous page turn by pair, go to page brings the page (or the pair) into view and, zoomed in, centres the page on the other side; the position kept for "Continue last notebook", saved views, the minimap, the fast scrollbar bubble, the page panel (both pages of the pair are highlighted) and file drops all use the page nearer to the point. Presentation mode still switches to one page at a time and back.
- Code. Pure
src/ink/spread.ts(layoutSpread,spreadRows,rowOf/mateOf,stepRow,canSpread,effectiveScrollMode,scrollToPageViewport,pageUnderScreen);ScrollModegains"spread",Layoutan optionalrows,nearestPagean optional sideways tie-break. SettingsspreadFirstAloneandspreadAuto. No document format change. - Tests.
tests/spread.test.ts; harness scenariodoc=spread(tablet held sideways and phone, light and dark).
Semantic zoom
- Semantic zoom (#130). Zoomed far out, the notebook shows its headings and names large over the pages, so the overview says what is where: each large handwritten heading as a picture of its own ink (level 1 with a stronger accent edge), titled bookmarks, the name and top-level outline of a PDF, and the names of large pictures and excerpts in a quieter style. They fade in below about 60 % of the fit-to-width zoom with a faint veil, are complete near the smallest zoom, stay inside their page and never overlap. A finger tap or a mouse click on a label zooms to that spot (a pen tap draws as usual). A view overlay only: the document, the stroke rendering and the stroke level of detail are untouched, and exports, the presentation, the hand-in and page-by-page mode never show it.
- Setting. Headings when zoomed out (Pages & navigation), on by default, in English and Italian.
- Cheap on the tablet. The layout is pure and cached per zoom band (
src/ink/semantic-zoom.ts), the labels come from the existing headings index and outline (src/model/semantic-sources.ts), at most 40 pooled elements move by CSS variables, a frame runs only when the viewport or the document changed, and heading pictures are drawn two per frame and cached. - Tests.
tests/semantic-zoom.test.ts,tests/semantic-sources.test.ts,tests/semantic-zoom-isolation.test.ts; harnessdoc=semzoom(dev/harness/semzoom-check.ts).
Workspace presets
- Workspace presets (#375). One command (Workspaces…, also in the All actions sheet and the notebook menu) lays out the plugin's panels around the notebook: Lecture (slides pane and the outline), Study (reference window and Related pages) and Focus (everything closed). Save the arrangement in front as a preset of your own (with the writing profile in use), then rename, replace or delete it; up to 12.
- Panels only. Applying a preset opens or closes the slides pane, the reference window, the page panel (thumbnails or outline), the minimap and the Related pages panel through their own open and close functions. It never moves other Obsidian tabs or panes and never edits a notebook, so it works on a read-only notebook too. Slides and the reference window ask for a file with their usual picker, one at a time.
- Phones. The reference window, the minimap and the Related pages are left out on a narrow screen (one notice names them); the slides split stays and the page drawer is skipped while it is open.
- Also. Workspace: Lecture as a one-tap action (ranked first during a class), the setting Lecture workspace when a class starts (Study, off by default), presets stored in the plugin settings (bounded, read leniently), long-press help, English and Italian. Document format unchanged (24).
PDF search suggestions
- PDF search with suggested terms (#418). Under the search box of a PDF a row of chips offers terms to search: the entries of the PDF's outline that the notebook shows, the titles in this notebook (box titles, bookmarks, marker labels) and the words you type most (text boxes, sticky notes, checklist labels; English and Italian stop-words left out). Typing narrows the row (prefix, word start, inside, one typo; accents and case ignored); a tap puts the term in the box and searches it. One scrolling line, up to 14 chips (8 on a phone), long-press explanations in English and Italian.
- Cheap and private. The list is bounded (about 240 terms), built when the device is idle, kept per open notebook and rebuilt only when its sources changed; typing only filters it. It reads the open notebook only, writes nothing and changes no format. Handwriting has no text, so it is not a source.
- Code. Pure
src/pdf/search-suggest.ts(tests `...
0.26.0
Eight features: opacity for ink, pictures and areas, smooth and straighten strokes, tidy up handwriting lines, redaction before export, pen width that follows zoom, a context palette in the colour picker, a dynamic gallery block and a related handwritten pages panel. The notebook format moves to version 24 (opacity): the migration from version 23 is automatic, and Notebook 0.25 and older open a v24 notebook read-only and never overwrite it. Four review rounds are folded in (see Review fixes).
Opacity and document format 24
- Opacity of ink, pictures and areas (#358) and document format 24. An Opacity slider (5 % to 100 %) in the pen options (the pen and its kinds, the shapes) and in the highlighter options (strokes and the area highlighter, with a value of its own): what you write next is that strong. It multiplies the pen's own look, so 100 % is exactly what every pen did before and the highlighter at 50 % is half of its usual translucency, still multiplied over the page. A favourite pen and a pen set keep it like the width, and the style eyedropper takes it from a stroke.
- Change what is already there. The selection bar has the same slider for the ink, the pictures and the area highlighters you selected: one step in the history (Opacity changed), undone in one go; groups come whole, a locked item or a text box is left alone, a mixed selection shows a dash until you move it, and the little button puts it back to 100 %. A selection of only a picture now has its bar too.
- Everywhere you see the page. The canvas, the stroke being written (also the wet ink of the pen, the highlighter and the marker, without a flash when it settles), the night look, PNG, SVG, PDF (one graphics state per strength, multiplied for the highlighter), the interactive HTML, the written-area and copy-as-image pictures, library cards, the page navigator and the hand-in PDF draw the same strength. A notebook that never uses it is saved exactly as before.
- Document format v24. One more optional number,
opacity(0.05 to 1), on a stroke of any pen, an image and an area, written only below 1. The v23 to v24 migration is the identity plus the version (a stray key of a v23 file is dropped); lenient reading clamps a number out of range and drops anything else, counted; strict writing refuses both; repair keeps a valid one; large v23 files are still read page by page. Older versions of the plugin open a v24 notebook read-only. The JSON Schema is nowdocs/schema/notebook-v24.schema.json. - Also. The Opacity action (all-actions sheet, ranked first with a selection of ink, pictures or areas and with the highlighter or a shape in hand, long-press explanations in English and Italian); Join broken strokes and the hook clean-up treat strokes of different opacity as different styles; merge keeps both copies of a stroke whose opacity differs.
- Code.
src/model/opacity.ts(the limits and helpers),src/ink/restyle.ts(planOpacity, oneUpdateItemsstep),src/view/opacity-row.ts(the shared slider row),inkAlpha(tool, opacity)insrc/ink/stroke-shape.tsas the one description of a stroke's alpha; tests intests/model-v24.test.ts; harness scenariodoc=opacity.
Tidy up
- Tidy up (#238). One step that straightens a page of handwriting: the words onto their baseline, the starts of the lines onto a common left margin, and oversized gaps between the lines closed. It works on the selection, or on the whole page when nothing is selected (Tidy up page in the page menu and the All actions sheet, Tidy up on the second row of the selection bar from tablet width, command Tidy up the selection or the page). A small sheet lets you switch each step on or off, shows how many words, lines and gaps would change and how much shorter the writing gets, and does nothing until Tidy up; Cancel leaves the page as it is. The choices are remembered on the device.
- Rules. The words are moved by the existing align-to-baseline engine; the lines are the ones it finds. Line starts within about two letter heights of each other become one margin (an indent stays an indent; on ruled paper the paper's margin line is used when the writing is next to it). A gap of two blank lines or more shrinks to one blank line, so paragraph breaks stay (switch Keep paragraph breaks off to close every gap to the usual line spacing). On ruled paper a line only moves by whole rules. Lines never end up on top of each other.
- Safe. Rigid moves of line-pen handwriting only (same points, pressure, width, id and layer). Shapes, the highlighter and the marker, pictures, text boxes, areas and every other element are never moved; neither are locked elements and the groups they belong to, a group that is not whole, ink a collapsed note keeps hidden, ink bound to a graph, and a line that has an underline, a drawing or an object in its way. A locked page refuses the step. One undo step ("Page tidied up" in the history panel); the page times are not touched. No format change.
- Code. Pure, Node-tested
src/ink/tidy.ts(reusesanalyseBaseline, which now also hands over the lines it found,selectableItems,applyPlacement); the sheetsrc/view/tidy-modal.ts;tidy()insrc/view/selection-actions.ts; registry actionsselection-tidyandpage-tidy(help text, context ranking, history title in English and Italian). - Tests.
tests/tidy.test.ts(two paragraphs, crooked lines, big gaps, ruled paper, a locked box in the middle, groups, hidden ink, one undo, page times, registry);tests/selection-arrange.test.ts(one id added to the second row). Not tried with a real hand or on Android.
Smooth and straighten strokes
- Smooth strokes and Straighten strokes (#66). Two actions in the All actions sheet (Selection) and the command palette work on the handwriting of the selection, each as ONE undo step with a notice that counts the strokes (history titles Strokes smoothed / Strokes straightened). Smooth takes the tremor out of the lines: a few Taubin passes (a smoothing step and a slightly larger step back, so curves do not shrink) with sharp corners held in place, no point moved farther than about a pen width, so the shape stays and only the wobble goes. Straighten turns a stroke that is almost a line (bend under 7% of its length, no loops, no doubling back) into a clean line between its two ends, each point keeping its share of the way; curves and short marks are left alone, and a second run does nothing.
- Safe. Strokes keep their id, layer, style, number of points and the pressure of every point; the first and last point never move. Shapes, the highlighter and the marker, invisible ink, ink bound to a graph, the ink a collapsed sticky note keeps hidden, text, pictures and area highlights are not touched; a group is reshaped only when wholly selected and without a locked element; a locked page refuses; the page times do not move. No format change; the stroke pipeline, the renderer and the golden render hashes are untouched.
- Code. Pure module
src/ink/smooth.ts(noobsidianimport),SelectionTools.reshapeinsrc/view/selection-actions.ts, registry entriesselection-smoothandselection-straightenwith long-press help, a context-ranking rule and English and Italian texts. Tests:tests/smooth.test.ts,tests/selection-arrange.test.ts; harness scenariodoc=smooth.
Redaction before export
- Redaction before export (#285). The export dialog has a new row, Cover parts of the page, with a Redact… button. It opens a page preview where you drag boxes (pen or mouse; a finger too while Draw with finger is on, otherwise a finger scrolls) over names, numbers or anything else that must not leave the notebook. The picture is exactly what the file will contain. A box can be removed with its cross, the last one undone, a page or everything cleared. Boxes are kept per notebook on this device only (bounded local storage; never in the notebook, the vault or sync) and applied by a switch, Apply the boxes, that turns on when you draw.
- Covered content is removed, not painted over. Ink is cut at a box (the parts outside stay, and so does the thickness of the pen: nothing of a line within its own width of a box is kept); a text box, picture, equation, graph, structured box, sticky note, marker, checkbox or excerpt that touches a box is dropped whole, with its text and its source; an area highlighter is cut round the box; margin comments anchored on a box go with their replies; the page header or footer is left out when a box covers it; bookmark titles of a covered page are not written to Markdown. The page's tags and drawing states are not drawn by any export and are removed from the copy. The box itself is a solid black rectangle drawn over everything.
- Backgrounds. A PDF page or a picture behind a page with boxes becomes a flat image of its own with the boxes burned in before it is encoded (a copy: the cached page is not touched), in the PDF (the original PDF text layer was never in the exported file; the burned picture is the only one), SVG, HTML, PNG, print, Markdown, share and hand-in alike, and also in a Background only export where no ink layer would show the box. Trade-off: that page's background can no longer be selected or searched as text. A background that cannot be burned is left out, never drawn as it is.
- Where it applies. Export… (PDF, SVG, interactive HTML, PNG images, Print, page ranges, split into sheets, clean copy), Hand in…, Share page…, Export as Markdown, the written-area / selection picture and Copy as image, the quick page exports, and the pictures put into notes by Insert selection into note, Make task, Look up later and the figures list, the figures' Copy image, the Highlights digest and the colour-meaning digest (neither quotes a PDF word a box touches), the book index, the formula sheet, and the public API's
exportPdf. In...
0.25.0
Seven features and a first part of the history: an area highlighter, a panel of the actions you took, align to baseline, lecture and study writing profiles, copy as image, a toolbar that fades while you write, a suggested paper for a new page and a page navigator view of marked pages only. The notebook format moves to version 23 (the area highlighter): the migration from version 22 is automatic, and 0.24 and older open a v23 notebook read-only and never overwrite it. Two independent review rounds are folded in (see Review fixes).
Area highlighter and document format 23
- Area highlighter (#99) and document format 23. The highlighter's options have Stroke | Area. In Area a drag from corner to corner puts a translucent rectangle on the page, in the highlighter colour, above the page background (a scanned PDF or a picture) and below all your ink and typed text, so what it covers stays readable. It looks exactly like highlighter ink (the same translucency, multiplied over the page; screened at night) and is dimmed by the colour-meaning filter like highlighter ink. It can be selected, moved, resized (the corner handle scales it in proportion; a quarter turn turns it, any other turn only moves it round, so it stays upright), recoloured with the highlighter colours in the selection bar, grouped, locked, copied, deleted and undone; the whole-stroke and segment eraser remove a whole area when they touch it and the same stroke of the pen has erased no ink (rubbing out a letter written on top of an area keeps the area; the Pen eraser filter spares it, the Highlighter filter always takes it) and the area eraser removes the ones inside its outline. A drag under 2 pt adds nothing. The action Area highlighter is in the all-actions sheet, ranked first while the highlighter is in hand and on PDF pages, with a long-press explanation.
- Everywhere you see the page. The canvas, the live drag preview, PNG, SVG (and so the interactive HTML and the written-area export), PDF, library cards, the page navigator and the hand-in PDF draw areas with the same look and order.
- Document format v23. One more element type,
area(x,y,width,height,color, plus the usualgroup,locked,lockAt). The v22 to v23 migration is the identity plus the version; lenient reading drops and counts an area with an invalid rectangle or colour, strict writing refuses it; repair keeps a valid one; older plugins open a v23 notebook read-only.docs/schema/notebook-v22.schema.jsonis nownotebook-v23.schema.json;docs/format.md, the architecture notes (why an element rather than a stroke flag) andtests/format-schema.test.tsare updated. The stroke pipeline and the golden render hashes are untouched. - Code.
src/model/area.ts(geometry),src/ink/area-render.ts(the one description of the look),src/ink/area-erase.ts; the drag reuses the shape tool's drag insrc/view/notebook-view.ts; tests intests/model-v23.test.ts.
Action history panel
- Action history panel (#84, panel only). Action history… (all-actions sheet, notebook menu, command palette) lists the steps of the open notebook newest first: a readable title per step ("Stroke written", "Added: text box", "Selection moved or transformed", "Erased"…), its page, how long ago, and how many items it touched. The point the document is at is highlighted (Now); undone steps are listed dimmed above it, and Start of the history is the last row. Tapping a step goes back, or forward, to the point just after it: every step is an ordinary History Undo or Redo, so the guards apply to each one (a locked page, a change the writer would reject, read-only mode); when a step is refused the jump stops there and a notice says how far it got. Long-press help in English and Italian; ranked higher in the actions sheet once steps were undone.
- Code.
Historyrecords the time of each step and exposesentries(),depth()andstepsTo()(no change of behaviour); the pure titles are insrc/model/history-describe.ts(every command class, every label the code uses, a generic fallback for an unknown command), the jump insrc/model/history-jump.ts, the list model insrc/view/history-panel-logic.ts, the dialog on the modal shell insrc/view/history-panel.ts. No document format change. - Not in this release: undo that survives reopening. The history is still emptied when the notebook is closed. Commands hold element objects by identity and private apply state, so saving them safely needs a serialiser per command class, re-linking to the freshly read notebook and a verified dry run, and the history would have to be saved at idle saves because Android can end the app without a close event. Roadmap #84 stays open.
Align to baseline
- Align to baseline (#93). Select handwriting and tap Align to baseline (second row of the selection bar on tablet widths, the All actions sheet everywhere, command Align the words of the selection to a common baseline): the words of each line are moved straight up or down onto one common baseline, in one undo step, with a notice that counts the words. On ruled paper the words go onto the ruled line instead. A line that is clearly written uphill or downhill keeps its slope and loses only the wobble.
- How it reads the writing. Words are found from the gaps between strokes (the dot of an i, a comma or a full stop go with their word), lines from the baselines, and the baseline of a word is where most letters sit, not the lowest ink: a g, p, y or q keeps its tail below the line, and the bar of a T or an f does not pull the baseline up. Everything is relative to the size of the hand, so large and small writing work alike.
- Safe. Strokes only translate in y (same x, pressure, width, style, id and layer; nothing is rotated, scaled or redrawn). Underlines, drawings, shapes, the highlighter and the marker, invisible ink, ink bound to a graph and the ink a collapsed sticky note keeps hidden are left where they are. A group moves as one unit, and a group that is not wholly selected or that holds a locked element stays put. A word that would have to move more than twice the height of the writing is left alone (it is another line). A move under a quarter of a point is not made, so a second run does nothing. The page times do not move (it is a move, not writing); a locked page refuses it.
- Code. Pure, Node-tested module
src/ink/baseline.ts(noobsidianimport; reusesapplyPlacement); the action insrc/view/selection-actions.ts(alignBaseline) and the registry (selection-baseline), with a long-press explanation, a context-ranking rule (higher on ruled paper) and English and Italian texts. No format change. On a phone-width bar (five places) the older actions keep their places and this one is in the sheet. - Tests.
tests/baseline.test.ts(synthetic words with descenders, punctuation, two lines, ruled paper, slopes, groups, locks, pinned ink, undo, page times, a 20-line page), and new cases intests/selection-arrange.test.ts,tests/context-rank.test.tsandtests/long-press-help.test.ts.
Lecture and study profiles
- Writing profiles (#219). A chip on the pen options (and the commands "Writing profile: Lecture / Study / next", also in All actions) switches the pens on the strip, the stabilization and the paper that new notebooks start on in one tap. Lecture has thin fast pens, light smoothing and ruled paper; Study has fountain pens, strong smoothing and grid paper. "Save current setup as a profile" keeps your own (up to 12; update or delete from the same menu). A pen set can be referenced by a profile; otherwise its pens become a normal pen set. The chip shows the profile only while the smoothing and paper still match it. A setting under Writing switches to Lecture when lecture mode starts (off by default). Switching changes tools and defaults only: no stroke, page or document is touched; no format change. English and Italian; long-press help and context ranking (Lecture first during a class). Not done: the optional toolbar density per profile.
Copy as image
- Copy as image (#277). Copy as image puts the selection, or the written area of the page, on the system clipboard as a picture to paste into messaging, mail and other apps. It is the last button of the selection bar's second row (from tablet width; on a phone bar it is in the All actions sheet) and Copy written area as image is in the page menu and the sheet. The picture is the transparent area export drawn at 2x, with a pixel cap for very large areas, painted onto white by default (new setting Background of copied pictures: White or Transparent, for apps that show transparency as black).
- Never silent. Where the WebView has no image clipboard the PNG goes to the system share sheet; where that is missing too, a PNG is saved next to the notebook (recorded as written by the plugin). Every outcome shows a notice, and closing the share sheet is not an error. No format change.
- Code. Pure decisions (size cap, routes, fallback order) in
src/ink/clip-image.ts; drawing and delivery insrc/view/copy-image.ts, reusing the area export's plan and renderer; English and Italian; long-press help; harnessdoc=clipimage.
Toolbar fades while writing
- Toolbar fades while writing and returns on the first touch (#399). Settings > Appearance > Toolbar while writing > Fade while writing (default: always shown, so nothing moves for anyone who did not ask): once the pen has been writing for the Fade delay (1 to 6 s, default 2), the toolbar, the contextual bar and the floating pills (recent symbols, back-to-page, referenced-on, welcome-back, lecture header) dim to 15% and come back that many seconds after the last stroke. A finger touch outside the page, a pen hovering over a bar or a press on a bar brings them back at once; the first finger touch on a dimmed bar only restores it and does not...
0.24.0
Eight features: filled shapes and dashed or dotted lines, joining of broken strokes, a context-ordered actions sheet, explanations on long press of an icon, tag suggestions, an adaptive page navigator, global bookmarks across notebooks and a hand-in dialog. The notebook format moves to version 22 (filled shapes and dashed or dotted lines): the migration from version 21 is automatic, and 0.23 and older open a v22 notebook read-only and never overwrite it. Two independent review rounds are folded in (see Review fixes).
Filled shapes, dashed lines and document format 22
- Filled shapes and dashed or dotted lines (#37) and document format 22. The shape tool's options have a Fill (none, solid, or a translucent tint, in the colour of the line or a palette colour) for the rectangle and the ellipse and a Line style (solid, dashed, dotted) for every shape; the selection bar restyles both for the selected shapes as one undo step (freehand ink is never touched, groups and locks are respected). Fill and dashes are drawn on the page, in the live preview, in the PNG, SVG, PDF and HTML exports, the written-area export and the thumbnails; tapping inside a filled shape picks it with the eyedropper.
- Document format v22. Three optional stroke fields, only on shape strokes:
fill,fillTint,dash. The v21 to v22 migration is the identity plus the version; a bad value is dropped and counted when reading and refused when writing; older readers open a v22 notebook read-only.docs/schema/notebook-v21.schema.jsonis nownotebook-v22.schema.json;docs/format.mdanddocs/architecture.mddescribe the fields. Old documents render exactly as before. - Code. Pure geometry in
src/ink/shape-style.ts(dash runs by arc length, scaled by the line width; closed-shape test; fill polygon), the selection restyle insrc/ink/shape-restyle.ts, one row builder for the options and the bar insrc/view/shape-style-row.ts; English and Italian.
Join broken strokes
- Join broken strokes (#313). When the pen briefly loses contact in the middle of a line, the line is saved as two strokes. Select the ink and tap Join broken strokes (second row of the selection bar, All actions sheet, command Join broken strokes in the selection): each pair that is one gesture split by a dropout becomes one stroke, in one undo step, with a notice that counts the joints. A chain of several fragments becomes one stroke.
- Conservative on purpose. Two strokes are joined only when they are neighbours in the page order, in the same style (tool, colour, width, nib, render version, slide) and the same group, both are real lines (a dot is never a fragment), the end of the first and the start of the second are a few points apart (a small multiple of the pen width and of the point spacing, and a small share of the shorter piece), the direction is continuous (no sharp turn: the corner of an L, a V and a dash pattern stay apart) and the pressure does not jump. Words, letters, the dot of an i, dashes and intentional pen lifts are never joined. Highlighter and marker strokes are not touched.
- Safe. The joined stroke keeps the id, style, group and nib of the first piece and the points of all pieces unchanged (still
[x, y, pressure]in page coordinates); the page order and the page times do not move; a locked page refuses it; the ink a collapsed sticky note keeps hidden, and strokes of a group that would shrink to one member or that holds a locked element, are skipped. Nothing is joined while writing and Clean up strokes does not join (they stay two separate actions). No setting, no document format change. - Code. Pure, Node-tested module
src/ink/stroke-join.ts(noobsidianimport); the action insrc/view/selection-actions.ts(joinBroken) and the registry (selection-join); English and Italian.
Actions ordered by context
- Actions ordered by context (#424). Obsidian does not let a plugin reorder its own command palette, so the plugin's All actions sheet does it: it opens with a short For this page section (up to five actions that fit what is in front of you: the selection, a PDF page, the lasso in hand, a lecture, the side pane, presentation mode), and the search ranks matching actions by designed importance, recent use and fit to the context. Library-level and diagnostic actions step back while a notebook is open. Commands that act on a notebook were already hidden from Obsidian's palette when no notebook view is active (
checkCallback); that is unchanged. No format change. English and Italian.
Explanation on long press of an icon
- Explanation on long press of an icon (#429). Hold a finger on a toolbar tool, the undo and redo buttons, the pen chip, a button of the selection or contextual bar, or a Home header icon: after about half a second a small bubble anchored to the icon says its name and, in one line, what it does (the tools also say that a second tap opens their options). The button is not pressed, and the bubble goes a moment after you lift, or at once when you tap elsewhere. A swipe, a quick tap, the mouse (it keeps its hover tooltip) and the pen (S Pen button rules and writing are untouched) never show it, and buttons with their own long press (the quick actions that pin, the page indicator quick tab) keep it. Settings > Appearance > Explain icons on long press turns it off. English and Italian; one shared helper (
src/ui/long-press-help.ts) with pure timing and placement logic (src/ui/long-press-logic.ts).
Tags suggested from context
- Tags suggested from context (#411). When you edit the tags of a notebook, or of a page, up to six suggestion chips appear: the course of the class linked to the notebook or its folder (timetable), tags that other notebooks in the same folder use, frequent words of the typed text and titles (English and Italian stop-words ignored), and what is on the page (questions, homework, definitions, theorems...). One tap adds the tag through the same path as before (notebook tags and page tags are still undo steps in the notebook). Computed on the device from what is already there: no AI, no network. New setting Suggest tags (Integration). The document format is unchanged.
Adaptive page navigator
- Adaptive page navigator (#414). The page panel now fits the notebook. When most pages have a PDF or picture background (an annotated PDF, slides) it shows large thumbnails in a wider panel; when most pages are written it shows a compact list (page number, title, the time the page was written, tags, and a small thumbnail); a mix keeps the usual layout. The title is the bookmark's title, else the first line of the topmost typed text on the page. A button in the panel header cycles Auto, Thumbnails and List; the choice is remembered per notebook on this device only (bounded local storage, never in the notebook or the vault). Thumbnails stay cached per page and width and are drawn lazily; the list is built in chunks and offscreen rows are skipped by the browser, so a 500-page notebook opens at once. No format change. English and Italian. Tests:
tests/nav-adapt.test.ts; harnessnavadapt.
Global bookmarks
- Global bookmarks (#265): pages from different notebooks in one list. Bookmark in the global list (page sheet and command, a toggle) adds the page in view to one list that covers every notebook; the same action removes it. Global bookmarks (command, page sheet, and a Bookmarks chip on Home once the list has something) opens the list in a dialog: tap a row to open the notebook at that page, rename a row, move it up or down, or remove it. A page that was deleted, or a notebook that cannot be found, is shown dashed with a Missing badge and can still be removed. The list is not part of any notebook: no format change, nothing is written into notebook files.
- Where it lives. One file per device,
_meta/bookmarks-<device>.json(the same sidecar pattern as quick tabs: a device writes only its own file, the latest change wins, a removal is kept as a tombstone for 90 days, entries and fields it does not know are kept, a file that cannot be read or is still empty from a sync is never overwritten). It names the notebook by path and by its own id and the page by page id, so it follows a notebook that is renamed or moved (a folder rename too) and finds again one that was moved where no rename was seen. The library check does not count it as holding any asset.
Hand in…
- Hand in… (#334). A dialog (notebook menu, Export & share sheet, command palette) that exports chosen pages as one PDF with a generated cover page first: your name (remembered on this device only), the course (prefilled from the timetable class linked to the notebook), the assignment title and the date. A grid of page pictures with checkboxes chooses the pages (the page in view at first; All / None). Below it a live pre-flight lists blank pages among the chosen ones and what is still open: gaps, questions and homework not done, unticked checkboxes, notes that say TODO and empty template boxes. Each row jumps to its page; Leave out the blank pages unticks them; the main button turns into Export anyway while anything is open. The PDF is the ordinary export, saved next to the notebook as
<notebook> hand-in.pdf(never over an existing file), recorded as plugin-written, and offered to the share sheet when the device has one. No format change.
Review fixes
- Long-press help never presses the button. The click that ends a long press is swallowed by a one-shot guard armed when the bubble shows, not by a clock from that moment: a finger held for two seconds on Delete, Cut or Clear page no longer runs it when lifted, and a quick tap on the same button right after is never swallowed.
- Join broken strokes. Ink bound to a graph is never joined with ink bound to another graph or with free ink (the joined stroke would be clipped to, or le...
0.23.0
Eight features: saved views, export of the written area or the selection, dimensional analysis of formulas, balancing of chemical reactions, an automatic formula sheet, a welcome-back card, notebooks ordered by the active term and clean-up of pen hooks and stray dots. The notebook format moves to version 21 (saved views): the migration from version 20 is automatic, and 0.22 and older open a v21 notebook read-only and never overwrite it. Two independent review rounds are folded in (see Review fixes).
Saved views and document format 21
- Saved views (#264) and document format 21. Save current view… keeps what is on screen (the page, the part of it that is in view and the zoom) under a name; Go to saved view… lists them and one tap brings you back. Rename, update to the current view, move up or down and remove from the menu of a row; each change is one undo step. A view of a page that was deleted is shown as Page missing and can be removed (Undo of the page deletion makes it work again). The views are kept in the notebook, so they travel with the file; recalling puts the middle of the saved region in the middle of the screen at the same zoom relative to the page width, so it works on another screen size. Copies of pages and pages moved to another notebook take no views along; merging a conflicted copy adds the views it has that the notebook lacks. In the sheet, the notebook menu and the palette; English and Italian.
- Document format v21. One optional notebook-level key,
views({ id, name, page, x, y, width, height, zoom }, at most 100, page coordinates only). The v20 to v21 migration is the identity plus the version, the reader drops invalid views and counts them, the writer refuses malformed ones, large v20 files are still read page by page, repair keeps the views; a notebook saved as v21 opens read-only in 0.22. The schema is nowdocs/schema/notebook-v21.schema.json(docs/format.mdand the format test follow). Tests:tests/model-v21.test.ts; harnesssavedviews.
Export the written area or the selection
- Export only the written area, or the selection, as a transparent picture (#280). Export written area… (page sheet, notebook menu and command) crops the current page to everything written on it, with a small margin; the Export selection as picture action on the selection bar does the same for the selected items alone (a selected collapsed sticky note brings its ink). Both write a PNG with a transparent background at 1x, 2x or 3x, or a vector SVG (every pen, the highlighter and marker transparency, text boxes with their link labels), next to the notebook, never overwriting, and remember the file as written by the plugin. Copy puts the picture on the clipboard where the device allows it. The sheet, the PDF or picture background and the paper are never drawn. An empty page says so and writes nothing. The document format is unchanged.
Dimensional analysis of formulas
- Dimensional analysis of formulas (#293). A quiet hint in the equation editor, under the preview, when the units of a formula do not agree: adding metres to seconds, an equation whose two sides differ (force against energy), a function or an exponent applied to something with a dimension. It reads units written with
\mathrm,\textor\SI(SI base units, prefixes from yocto to quetta, the named derived units N, J, W, Pa, Hz, C, V, Ω, S, F, H, T, Wb, lm, lx, Bq, Gy, Sv, kat and common others such as min, h, L, t, eV, bar, atm, cal, Wh, ft, in, mi, lb), follows dimensions through + − × ÷ ^, roots, fractions, derivatives (\frac{dx}{dt}), integrals, sums and limits, and takes the dimension of a symbol from the value it is set equal to (m = 2\,\mathrm{kg}) or from a line[v] = m/s. A symbol it knows nothing about is never flagged. Only dimensions are compared, not scales (3 m + 2 kmis fine). When the units agree it shows a muted tick line. Nothing is stored and the document format is unchanged. - Setting. Settings > Writing > Check units in equations (on by default).
- Code. Pure, Node-tested engine in
src/math/dimensions.ts(noobsidianimport; also reads plain text such as5 m + 3 s); the words insrc/view/dimension-hint.ts; English and Italian.
Balancing chemical reactions
- Balancing of typed chemical reactions (#294). Select a text box or an equation that holds a reaction and tap Balance reaction in the selection bar (or the command): a preview shows each line before and after, and Balance replaces the text with the smallest whole coefficients in one undo step. Formulas with parentheses and brackets, hydrates (
CuSO4·5H2O), charges (Fe^3+,SO4^2-,Fe³⁺,e^-) and arrows (->,→,⇌,=) are read; the species keep the spelling they were typed in. The coefficients come from an exact rational nullspace of the element and charge matrix (no rounding). A reaction that cannot be balanced says why (an element on one side only, unknown element, unclear charge, no positive solution, a species that cannot take part) and one with several answers says so instead of picking one. Locked elements and locked pages are never changed. An equation becomes\ce{...}. No format change.
Automatic formula sheet
- Automatic formula sheet (#249). Formula sheet… (page sheet, notebook menu, command Build formula sheet) collects every equation of the notebook in reading order and writes
<Notebook> — Formulas.mdnext to it: a heading with a link per page and a$$…$$block per formula (\tag{n}for numbered ones). The note is owned by the plugin throughnotebook-formulasmarkers that record the notebook's path and document id; a rebuild replaces only that region (re-read insidevault.process), and a note without markers, with an unpaired marker or recording another notebook is never rewritten. No document format change; the notebook file is never written.
Welcome-back card
- Welcome-back card when you reopen a notebook (#420). After a notebook has stayed closed on this device for a while (default 8 hours; Settings > Study > Timetable > Welcome back card and Offer it after, 1 to 168 hours), a quiet card at the top centre offers the way back to where you were (the notebook's stored reading position, named slide N when that page shows a PDF page) and the first open questions and gaps already marked in the notebook (question and gap markers that are not resolved; the rest is counted as plain text). Every row is a button that goes there. The card appears once per opening, goes away on the first stroke, on the close button or when a row is taken, steps aside while the Referenced on list is open, and stacks below the symbols strip, the Back to slide pill and the Referenced on chip. The only thing stored is the time the notebook was last open, in this device's local storage (bounded to 80 notebooks, corrupt data read as empty); the notebook file, the format and the settings file of other devices are untouched. Pure selection logic:
src/model/welcome-back.ts,tests/welcome-back.test.ts; view:src/view/welcome-back.ts.
Notebooks ordered by the active term
- Notebooks ordered by the active term (#416). The Library sort menu has Active term (Semestre in corso): notebooks linked to a course of the term that includes today come first, the one whose next class is soonest first (then course order in the timetable), then notebooks of the courses whose term is over or not yet started, then every other notebook, each group by last change. The link is the one the timetable already has (a class's notebook or course folder); nothing new is stored and the document format is unchanged. The option is hidden without a timetable and falls back to last-modified. It becomes the default only when a class has dates around today and you have never chosen a sort; picking any sort (or having one saved) keeps your choice.
Clean up hooks and stray dots
- Clean up hooks and stray dots (#314). Clean up strokes in the contextual bar of an ink selection (and in the All actions sheet and the command palette) trims the small hook a pen leaves where it lands or lifts, and removes the stray dot a bouncing pen leaves touching the end of a stroke, as ONE undo step. A notice says how many hooks and dots went. Only the points at the very start or end of a stroke are cut; the stroke keeps its id, style, group and nib, and its place in the page order.
- Conservative on purpose. A hook is a tick of at most a few pen widths (6 pt at most) and a tenth of the stroke that turns back at 120 degrees or more against a straight run of line. Real corners (the foot of an L, a check mark, an arrow barb, a Z or a W), curves and circles are never cut. A dot is removed only when it is a single tiny mark in the same pen, colour, width and nib as the stroke written just before or after it and touches one of its ends: the dot of an "i" or "j" and a full stop sit apart from the stroke and stay. Grouped dots and hidden ink are left alone.
- Respects the page. Groups come whole, the ink a collapsed sticky note keeps hidden is never touched, a locked page refuses the step and says so, and the selection stays on the cleaned strokes (also across pages).
- Setting Trim hooks as you write (Settings > Writing, off by default). When the pen lifts, the stroke is committed as written and a hook at its start or end is cut as a step of its own, with stricter limits than the manual clean-up; one Undo gives the written stroke back. The live input and the rendering are not touched, and a snapped or recognised stroke is left as it is.
- Code. Pure
src/ink/hook-clean.ts(findHooks,trimHooks,isStrayDot,planCleanup), tested with synthetic strokes intests/hook-clean.test.ts. No document format change.
Review fixes
- Balance reaction keeps the rest of an equation. Only the lines of an equation that are a reaction and get balanced are rewritt...
0.22.0
Seven features: three new pens, optional cloud sync with Google Drive or OneDrive, two-way page references, colours with meaning, instant axes, custom covers and an automatic lecture header. The notebook format moves to version 20 (the new pen tools and the nib angle): the migration from version 19 is automatic, and 0.21 and older open a v20 notebook read-only and never overwrite it. Cloud sync is off by default and uses your own OAuth client; the plugin ships no client ID or secret.
How the new features work together
- The cloud sync is joined to the Google Drive and OneDrive sign-in at load; Google's client secret lives under one device-local key and never in the token blob,
data.jsonor the vault. The new pens: ghost guide lines and scribble to erase work with the fountain pen and the brush (not the marker), the colour-meaning filter dims the marker too, and an L or a cross drawn with the marker is not turned into axes. Floating pills that share a corner (slide-back, symbols strip, "Referenced on", colour-filter pill, lecture-header chip, a parked minimap) are stacked instead of overlapping. The pen options popover leaves a strip of page below it on a phone held sideways, so a tap on the page still closes it.
New pens and document format 20 (#35)
- New pens (#35): fountain pen, brush and marker. The pen options have a Pen type row. The fountain pen is a nib: lines drawn along the nib angle are thin, lines across it thick (pressure still modulates the width, ends are crisp, nothing tapers). The brush answers to pressure (fine tip to full belly) and speed (thinner when it is fast), grows from a point and closes to a point. The marker is a flat chisel: constant for any pressure, a little narrower along the nib, 85% opaque and painted in stroke order (above the ink written before it, with that ink showing through), not multiplied like the highlighter. The fountain pen and the marker have a Nib angle (a slider with a little bar that leans like the nib); the angle is stored on the stroke. The same look in the canvas, the wet ink, thumbnails, SVG, PDF, PNG and the interactive HTML export; eraser, lasso and moves work on their outlines, and a rotated selection turns the nib with it. A hold-still shape made with a new pen becomes an ordinary shape.
- Favourites, pen sets and the style eyedropper remember the kind (and the nib angle). Settings > Writing has Pen type (the pen the pen tool starts with) and Nib angle.
- Document format v20. The tools
fountain,brushandmarker(alwaysrender2) and the optional stroke fieldnib(whole degrees 0 to 179, absent = 45, only the fountain pen and the marker have one). The v19 to v20 migration refuses a v19 file that already has a new tool (no version wrote one) and drops a straynibkey; read leniently, an unknown tool name is a pen (counted) and a bad nib is dropped (counted). 0.21 and older open a v20 file read-only.docs/schema/notebook-v20.schema.jsonreplaces the v19 schema; the geometry of the pen, highlighter and shape is frozen by golden tests (tests/pens-golden.test.ts).
Cloud sync with Google Drive and OneDrive (#126)
-
Cloud sync with Google Drive or OneDrive (#126), the engine and the settings. Off by default and opt-in per device, no telemetry. Settings > Sync & safety has a Cloud sync group: the service, your own OAuth Client ID (the same on every device; Google's Client secret stays in this device's local storage, never in
data.json), the account (Sign in, Change folder, Disconnect), Sync now with the last result (Stop while running, Review when a run waits for a decision), what to sync (whole vault, selected folders, or include / exclude globs and file types), sync on open, on close, every N minutes, Wi-Fi only (where the network type is unknown, a phone or tablet holds the automatic runs and a desktop runs), a large-file rule (ask or skip above a size) and the activity log of the last 50 events. Command Cloud sync now; a status bar item on desktop..obsidian,.trash, temporary files and the backup folder (#127) are never synced. -
Safety rules. Three-way sync against a per-device state in the plugin folder (
cloud-sync/state-<device>.json, remote index and base with SHA-256): the first sync is a union and deletes nothing; a deletion is propagated only from a synced, unchanged state and always to the trash (Obsidian's on this side, the cloud's on the other); more than 20 deletions (or 3 and over 30 % of the tracked files) stop the run and ask (Keep them copies them back, Delete them goes ahead); a file changed on both sides keeps both, the cloud's asName (conflict YYYY-MM-DD HH.MM Device).ext, which the #122 merge offer recognises; uploads are conditional on the cloud revision and the run re-plans when the cloud changed meanwhile; open notebooks are saved before upload and never replaced while they hold unsaved ink; downloads go through the usual external-change reload. A damaged state file is kept as.bad.jsonand the next run lists everything again without deleting. Transient errors retry with back-off (honouring retry-after); a sign-in problem stops and asks to sign in again; a missing cloud folder is an error, never "everything was deleted". No document format change. -
Code. Pure, Node-tested logic in
src/sync/(rules.ts,state.ts,planner.ts,conflict-name.ts,engine.ts,settings.ts,network.ts,sync-memory.ts); Obsidian wiring insrc/sync/sync-service.tsandsrc/sync/vault-adapter.ts; the sign-in contract insrc/sync/auth-ui.ts, implemented over the providers bysrc/sync/auth-adapter.ts(wired insrc/sync/auth/obsidian-auth.tsand plugged in at load withcloudSync.setAuth; Google's client secret has ONE device-local key and is kept out of the token blob, the client ID is the only OAuth value in the synced settings, and the Account row says that every device must use the same client ID because Google'sdrive.filescope only shows the “Notebook sync” folder this client created); UI insrc/view/cloud-sync-settings.tsandsrc/view/cloud-sync-modals.ts. Tests:tests/sync-planner.test.ts,tests/sync-rules.test.ts,tests/sync-state.test.ts,tests/sync-engine.test.ts; harnessdoc=synccore. -
Cloud connector: Google Drive and OneDrive providers and sign-in (#126, part 2). Sign-in with the OAuth 2.0 device code flow (RFC 8628), the same on Android and desktop: a dialog shows the code and the address, with Copy code, Open sign-in page, a countdown and Cancel, and handles denied, expired, refused-client and network failures with Try again. The plugin ships no client ID or secret: you register your own app (step-by-step guide in
docs/cloud-sync.md). Google usesdrive.file(the only Drive scope the device flow allows besides the hidden app folder), so everything lives in aNotebook syncfolder the plugin creates; OneDrive usesFiles.ReadWrite.AppFolder, so everything lives in the plugin's app folder (Apps/<app name>) and nothing else of the drive is visible. Tokens stay on the device (Obsidian's local storage), refresh by themselves, are never logged; Disconnect revokes them where the provider allows (Google). Both providers list changes incrementally (Drive changes feed, OneDrive delta) with paths rebuilt from parent ids, upload large files in chunks, refuse to overwrite a remote file that changed (If-Matchon OneDrive, a revision check just before the write on Drive), move removed files to the remote trash (never a permanent delete), and retry 429/5xx with backoff andRetry-After. HTTP only throughrequestUrl. No format change.src/sync/auth/,src/sync/providers/; teststests/sync-*.test.ts; harnessdoc=syncprov.
Colours with meaning (#101)
- Colours with meaning (#101). Settings > Reading & PDF > Colour meanings opens a legend editor: give each ink colour a name (red = definition, blue = example), reorder, recolour, add and remove; Add the usual meanings starts from red / blue / green. Colour matching (strict, normal, loose) says how close a stroke's colour must be to a legend colour; two legend colours that are too close are flagged. A notebook can have a legend of its own (its menu, Colour meanings…), kept in
_meta/meanings-<device>.json(one file per device, like the quick tabs; read leniently, unknown fields kept, an unreadable file is never overwritten). - Filter by meaning. The notebook menu has Filter by meaning…: choose a meaning and the ink of the others (and of no meaning) is drawn faint, with a pill at the bottom left to clear it. It is view-only (the renderer redraws its static layer once; nothing is saved and the document is not touched) and not kept when you switch notebook.
- Digest by colour. Digest by colour… writes
<Notebook> — Colours.mdnext to the notebook: one section per meaning in legend order, a picture of each place the colour was used (close ink of one meaning is one place), the PDF text under it and a link to the page. Only the part between thenotebook-meaningsmarkers is rewritten; your text around it stays, a second run makes no new pictures, an unpaired marker is left alone and a note of yours with that name is added to only after you agree. - No document format change. New:
src/model/colour-meaning.ts,src/library/meanings.ts,src/library/meanings-store.ts,src/view/colour-meaning.ts,src/view/meaning-modals.ts,src/view/meaning-digest.ts; the renderer has a view-onlysetInkDim.
Custom covers (#53)
- Custom covers (#53). Change cover… (library card menu and the notebook tab menu) opens one dialog with four sources: a generated Pattern (families, colour, new variation), an Image from the vault or the device, a Page of the notebook (stepper) and five designed Templates (Classic, Band, Frame, Minimal, Poster) that put the notebook name on generated art. Images and page...
0.21.0
Eight features: a start and end time on every page, scheduled backups, a documented file format with a JSON Schema, an interactive HTML export, a back-of-book index, a reusable signature and date stamp, a way back to the current slide and a strip of recent symbols; plus the review fixes carried over from 0.20. The notebook format moves to version 19 (page start and end times): the migration from version 18 is automatic, and 0.20 and older open a v19 notebook read-only and never overwrite it.
Start and end time on every page (#217) and document format 19
- Start and end time on every page (#217), document format 19. A page now remembers when the first ink or object was added to it and when the last one was. They show in the page header line (when the header is on), on the cards of the notebook map (tooltip, label and a quiet line under the thumbnail) and in Page information (Page started, Page last written). The new setting Show when a page was written (Pages > Header) hides them from the header and the map; the page information always shows them. A page written before this version has none until something is added to it. They are also the time base audio recorded with a page will use (M5).
- Document format v19. Pages get an optional
startAtandendAt(ms since 1970, written together, end not before start). The v18 to v19 migration only drops these keys from a v18 file, so large v18 files still open page by page; a lone, fractional, out-of-range or inverted pair is dropped and counted when read and refused when written; 0.20 and older open a v19 notebook read-only and never overwrite it. The times are upkeep, not an edit: they are stamped by the history after a command that adds ink or an element succeeded, have no undo step of their own, and Undo and Redo never move them. A duplicated page, a template and a page made from one start without times; a page moved to another notebook or restored from the page trash keeps them; restoring an old version keeps the earliest start and latest end. A merge of conflicted copies takes the earliest start and the latest end and never stamps the moment of the merge. Repair keeps a valid pair and resets an invalid one. Seedocs/architecture.md, Page start and end time, format v19.
Scheduled backups (#127)
- Scheduled backups (#127). Settings > Sync & safety has Scheduled backups (off by default, every day or every week), Backup folder (a vault folder, default
Notebook backups; point your own sync tool at it to copy the zips elsewhere) and Backups to keep (default 5), and a Back up now row that shows the time and result of the last backup; the command palette has Back up the notebooks now. A backup is oneNotebook backup YYYYMMDD-HHmmss.zipwith every notebook file, the_assetsand_metafolders and the templates, read as they are on disk after the open notebooks were saved; the trash, the_backupcopies and the backup folder itself are left out. While Obsidian is open the schedule is checked a minute after start-up, every half hour and when the app returns to the foreground; a backup made by another device and synced here counts. It waits for the pen, reads in short slices with a progress notice, runs one at a time, writes under a temporary name, checks the size, renames, and only then trashes the older plugin-written backups beyond the number to keep (through Obsidian's trash, and only files that carry the plugin's exact backup name; the newest complete backup is never trashed to make room for partial ones). A file that cannot be read (a notebook still arriving from the sync client) is skipped and the backup is markedpartial. A failed run leaves the older backups as they were and the next try waits an hour. The folder is not part of the library, the shared-files inbox or the companion notes. No format change; no Drive and no folder outside the vault (the plugin has no Node or Electron access); the zip is built in memory, so a vault above 64 MB on a phone or tablet (1 GB on a computer) is refused with a message. Own STORE-only zip writer and strict reader insrc/model/zip.ts(no library, no licence to record), rules insrc/storage/backup-logic.ts, one run insrc/storage/backup-run.ts, Obsidian wiring insrc/storage/backup-service.ts. Tests:tests/zip.test.ts,tests/backup-logic.test.ts,tests/backup-run.test.ts,tests/backup-wiring.test.ts.
Documented format with a JSON Schema (#167)
- Documented format with a JSON Schema (#167). New
docs/schema/notebook-v19.schema.json(JSON Schema draft 2020-12, format 19, with the page timesstartAtandendAt) describes the.notebookfile exactly as the plugin writes it: document, meta, pages, strokes, all nine element types, comments, states, slides, groups and locks, every optional field, enum and limit. Newdocs/format.mdis the guide for third-party tools: file layout, versioning and migration policy, how to read leniently, the_assetsand_metafiles, a minimal example. A test validates real serializer output (a document that uses every element type and optional field) against the schema with a small dependency-free validator, and checks that invalid documents are refused. No format change and no runtime change.
Interactive HTML export (#164)
- Interactive HTML export (#164). Export… has a new format, Interactive HTML: one self-contained
.htmlfile (whole notebook, this page or some pages, ink and background choices and Clean copy as in the other formats) that opens in any browser without Obsidian. Each page is the inline SVG of the SVG export, with a small vanilla-JS viewer: page strip, wheel and pinch zoom, pan, fit width, keyboard navigation, light and dark by the system theme, links to pages of the notebook ([[Name#p3]]) that jump inside the file and web links that open normally. Pictures are embedded up to about 32 MB (a notice says how many were left out); a Content-Security-Policy forbids any network request; titles and text are escaped. The page strip fills its thumbnails only as they scroll into view (a 500-page file opens at once), and printing the file prints every page, one per sheet. Written next to the notebook, never over an existing file; built one page at a time. No format change. Pure builder insrc/ink/export-html.ts, writer insrc/view/export.ts. Tests:tests/export-html.test.ts. Harness:dev/harness/htmlexport-check.ts(doc=htmlexport).
Back-of-book index (#187)
- Back-of-book index (#187). Add to index… (selection bar and sheet) turns the lasso selection into an ordinary star marker labelled
#idx <term>; Back-of-book index… (page sheet, notebook menu, command palette) lists the terms A-Z with a page chip each (a tap goes to the page), sub-terms writtenTerm / Subtermnest, equal terms merge whatever the case or accents, and Write to note writes the list to<Notebook> — Index.mdnext to the notebook (only the generated region is rewritten; a note of yours without the markers is left untouched). Settings, Reading: Index term prefix. No format change. Pure logic insrc/model/book-index.ts, dialogs insrc/view/book-index.ts. Tests:tests/book-index.test.ts. Harness:dev/harness/bookindex-check.ts(doc=bookindex).
Reusable signature and date stamp (#154)
- Reusable signature and date stamp (#154). Sign and date (page sheet, Insert; command palette) opens a dialog with your saved signature. Draw signature opens a pad (finger, S Pen or mouse; undo, clear) and saves it as the personal stamp "My signature", so it syncs with the vault and shows in the stamp palette; no format change. Place puts the signature, scaled to a standard width, and today's date under it where the pen last touched (or the middle of the page in view) as one undo step; the items share one fresh group so they move together, a locked page refuses it. The date follows two new settings (Writing, Advanced): Signature date format (your language, ISO, custom) and Custom signature date pattern. Pure logic in
src/ink/signature.ts, storage insrc/storage/signature.ts, dialogs insrc/view/sign-dialog.ts. Tests:tests/signature.test.ts. Harness:dev/harness/signstamp-check.ts(doc=signstamp).
Back to the current slide (#225)
- Back to the current slide (#225). While lecture mode is on (or when you write beside a linked slide), the notebook remembers the place you last wrote. Scroll half a screen or more away from it and, once the scroll stops, a small pill at the top of the view offers the way back: Back to slide N (the PDF page or linked slide) or Back to current page, with an arrow towards it. Tapping it returns like a jump from the notebook map (recorded in the back history) and puts the written line near the middle of the view; the pill can be closed and comes back after you return and leave again. The command Back to the current slide or page does the same (no default hotkey). New setting Back to the current slide (Study, Timetable; on). The place lives in memory only: no format change, nothing written. Pure logic in
src/model/slide-back.ts, the pill insrc/view/slide-back.ts. Tests:tests/slide-back.test.ts. Harness:dev/harness/slideback-check.ts(doc=slideback).
Recent symbols (#212)
- Recent symbols (#212). A strip at the top of the page area with the symbols you use most: typographic ones (∀ ∃ ∫ → ⇒ ≠ ≤ …) and signs you saved with Save selection as symbol. Tap one, then tap the page: a character becomes a text box, a saved sign is drawn about one line high in the current pen colour and width (one group, one undo step, fresh ids). Ordered by use with decay (a use counts half as much after two weeks); counts stay on the device. Symbols are small personal stamps, so there is no format change. Settings, Writing: Recent symbols and Symbols shown.
Review fixes
- **Dropped files are never trashed after a recorded chan...