Create a new note file

When no notebooks exist, choose Create New Note File. You can also create one from the unified module selector when the Notes book type is active (same flow exists wherever “new note file” is offered).

1. Name — This becomes the display title. The file name is built by replacing spaces with underscores, under UserDocs/notes/<name>.note.ywm.
2. Language — Metadata for the notebook (used with editor and UI language; Arabic sets RTL by default when selected).
3. Right‑to‑Left (RTL) — Toggle for languages written right-to-left; you can override the default for any language.
4. Confirm with Create. The app creates the file, opens it, and you can add topics.

Topics (outline) and sidebar

Each notebook stores a tree of topics. One topic’s HTML is shown in the editor at a time.

• New topic — From the topic list header (or context actions), add a root topic or a sub‑topic under an existing row.
• Select — Tap a topic to load its content in the editor.
• Expand/collapse — Topics with children show an arrow to expand the subtree.
• Reorder — “Move up / Move down” in the ⋮ menu, or drag a topic: drop on the gap before/after a row to reorder as a sibling, or onto a row to nest under that topic.
• Rename / delete — From the ⋮ menu. Deleting removes that topic and all nested sub‑topics (confirmed in a prompt).

Header strip: Switch Note File opens the unified selector to pick another notebook or topic; Notebook Settings edits title/language/RTL and related metadata; Close Sidebar hides the list (a small “Show Topics” control brings it back).

Saving

Edits are saved automatically a few seconds after you stop typing. Switching topics or closing saves pending changes first. You do not need a manual Save button in the Notes tab editor (the small verse-note dialog elsewhere may still use Save—see Verse menu).

Move a user module into Notes (“Edit in Notes”)

User books installed as regular modules (*.bok.ywm outside the notes folder) open read-only in the book reader. To edit that content with the Notes HTML editor:

1. Open Module manager (or the selector entry that lists user modules).
2. Choose Edit in Notes for that module.
3. Confirm. The app converts all topic bodies to HTML, moves the file into UserDocs/notes, and renames it to the *.note.ywm pattern so it appears under Notes notebooks.

If a file with the same name already exists in the notes folder, the operation is blocked—you must rename or remove the conflict first.

The reverse operation—“Convert to read-only book”—moves a notebook from UserDocs/notes back to a user module as *.bok.ywm for read-only reading in the library.

Verse references: bottom sheet vs preview dialog

Tapping a verse link in the note (a reference you inserted as a tw://bible/… link) opens a verse preview dialog in the middle of the screen—not the bottom sheet. You can resize the dialog by dragging the corner handle; the app remembers the size for next time.

The bottom sheet (panel that slides up from the bottom) appears in two situations:

• After you tap Find verse in the editor toolbar and choose a passage in the Bible selector.
• When you long-press in the note text and the editor recognizes a verse reference at that position.

Bottom sheet options (in order)

1. Preview Verse — Closes the sheet and opens the same verse preview dialog described below, so you can read the passage in context before changing your note.
2. Insert Full Verse Text — Pastes the verse text from your default Bible into the note at the cursor (for a range, multiple verses are included with verse markers). The plain text is appended with the reference in parentheses.
3. Insert as Link — Inserts (or replaces the selection with) a standard tappable verse link that shows the formatted reference and jumps to scripture when tapped.
4. Remove Link — Strips the link from the current selection while keeping the visible text (useful when the caret is inside or on a verse hyperlink).

Verse preview dialog (after a link tap, or after Preview Verse)

• Bible / translation — Dropdown on the left to choose which installed Bible module loads the text in the preview. The choice is saved for the next time you open this popup.
• Show Chapter / Show Verse Only — Toggles between a single verse (or short passage) and the full chapter in the preview (icon switches between a “chapter” and a “list” style).
• Copy — Copies the preview body text to the clipboard (plain text from the rendered passage).
• Close — Dismisses the dialog. If you follow another scripture link inside the preview web content, the app may send that location to the main Bible panel and close the dialog.
• Zoom — Controls in the footer adjust text scale in the preview; the zoom level is remembered for later popups.

Related

• Verse menu — verse-level notes (compact editor) and links into study features.
• Highlighting verses
• Verse tags
• Module manager