Refine Page Linking workflow

README.md

@@ -212,18 +212,25 @@ Supported input examples include:
 - `2026-01-30 13:45`
 - `2026-01-30T13:45:00`
 
-### 0.2) Editor toolbar: Page Link
+### 0.2) Page Link: link a page to a folder
 
-The **Page Link** toolbar button creates a page-scoped UUID and stores it in
-page metadata. This UUID is used to link the page to a folder that contains
-a `.pagelink` file with the same UUID.
+Page linking uses a page-scoped UUID stored in page metadata. This UUID is used
+to link the page to a folder that contains a `.pagelink` file with the same UUID.
 
-Workflow:
+The Page Link workflow is driven by the **Page ID link** in the page info area
+(page footer, `.docInfo`):
 
-1. Click **Page Link** in the editor toolbar to create the UUID.
-2. View the page and copy the UUID from the “Not linked: Copy ID” status.
-3. Create a `.pagelink` file in the target folder (within your configured
-  `paths` roots) and paste the UUID into that file.
+1. **Link Page** (page has no UUID yet)
+  Creates the UUID and downloads a `.pagelink` file.
+2. **Download Link File** (page has UUID, but no linked folder found)
+  Downloads the `.pagelink` file.
+3. **Unlink Page** (page is linked)
+  Prompts for confirmation, removes the `.pagelink` file from the linked folder
+  (if found), removes the UUID from the page, and refreshes the page.
+
+After downloading the `.pagelink` file, place it into the folder you want to
+link (within your configured `paths` roots). Once DokuWiki can discover it,
+the page becomes “linked”.
 
 Once linked, you can use `blobs/` as an alias in luxtools syntax on that page,
 for example: