The form for a new to-do: title, text, notebook, tags and a due date, opened by the shortcut over the note you are in The date picker unfolded under the Due row, with its calendar, time columns and quick buttons Two highlighted lines become the title and text of a new to-do, with the choice of what happens to them in the note Typing ++ in the Markdown editor opens the form, and the ++ becomes a link to the new note or is removed Edit with Jot… changes an existing to-do's title, type, notebook, tags and due date without opening it

Description

Quick capture of a note or to-do without leaving the one you are in. A small form for the title, a line or two of text, the notebook, tags and the due date, opened by a shortcut, from highlighted text, or by typing ++ in the editor. The note is created where you say, and you stay where you were.

Additional Information

Links:
Maintainers: pmslava
Version:0.4.0
Minimum app version:3.1
Downloads: This version:35
Last updated:2026-11-05T17:27:29Z

Jot

Quick capture of a note or to-do without leaving the one you are in.

Jot's form in Joplin's dark theme: a new to-do with its title, text, notebook, tags and a due date

While you read or work in one note, Jot opens a small form for the title, a line or two of text, the notebook, tags and the due date, creates the note from it, and does not open it. You stay where you were. Joplin's own New note and New to-do create an empty note and open it, and Back lands at the top of the note you were reading; Jot exists so that never happens.

Tested on the desktop and on Android. On a phone the ways in are the Jot button in the note toolbar and the typed trigger; the menus are desktop only.

Install

In Joplin, Settings › Plugins › search for Jot and install it. Or download io.github.pmslava.jot.jpl from the releases page and use Settings › Plugins › Install from file.

Ways in

  • Tools › Jot…, with Ctrl+Shift+J as its shortcut on every platform (change it under Options › Keyboard Shortcuts).

  • Jot from the selection… in the editor's right-click menu. The first line of the highlighted text becomes the title and the rest the text, or all of it the text, by setting. The shortcut does the same when text is highlighted.

    Two highlighted lines in the Markdown editor and the form opened from them, title and text prefilled, with the In this note row
  • Typing ++ at the start of a line or after a space in the Markdown editor. The trigger is a setting; empty turns it off. It never fires inside a word (C++), inside code (a fenced or indented code block, or an inline code span), on a paste, or twice for the same occurrence: cancel the form once and that ++ is left alone.

    A line ending in ++ in the editor and the form it opened, offering to replace the ++ with a link or remove it
  • The Jot button in the note toolbar, the feather icon.

  • Edit with Jot… in the note list's right-click menu: the same form prefilled with the note's title, type, notebook, tags and due date. Save writes only what you changed, and the note is never opened.

    The form in edit mode, headed Edit to-do, prefilled from an existing to-do, with Save and Cancel

The form

Type, Title, Text, Notebook, Tags, then the choices, and Due last. The title is focused when the form opens, so typing a title and pressing Enter is all a capture needs; Enter creates from anywhere in the form except the Text, where it is a new line, so a date picked with the mouse is followed by Enter as well; with the title still empty, Enter keeps the form open and puts the cursor back in the title. Every choice is one line of buttons you click or move through with the arrow keys:

  • Type: Note or To-do, in the order of Cockpit's buttons.
  • In this note, when the form was opened from highlighted text: Replace with link (the default), Keep text, or Add link after. Opened by ++: Replace ++ with link (the default) or Remove ++. Each starts on its setting.
  • Back link: Add puts a line linking to the note you are in at the top of the new note, then an empty line, then the text (or at the bottom, by setting). Hover Add to see the line. It starts on the setting, Don't add unless you change it.
  • Open: No (stay where you are, the default), In editor, or New window. It starts on the setting.
  • Note Tabs, when its setting is on: Pin (the new note becomes a pinned tab in the Note Tabs plugin, without being opened) or Don't pin. It starts on the setting.

Jot tells two kinds of note apart. A quick note is one you start with nothing highlighted, from the shortcut, the menu or the toolbar button: a reminder to deal with later. A note from text in a note is one you start from highlighted text or by typing ++: it belongs with the note it came from. By default:

  • Notebook starts on the notebook setting for that kind of note: by default the notebook of the note you are in, for both. Set the one for quick notes to an inbox, say, and reminders land there while notes from text stay next to their source.
  • Tags stay empty for a quick note. For a note from text they start with the tags of the note you are in, followed by a comma and a space, so you can clear what does not fit or type the next tag straight away.
  • Back link starts on Don't add, for every note, until you choose otherwise in Settings.

Each of these is a setting, so a quick note can be just the shortcut, a title and Enter, and a note from text can come out ready, with no clicks. Notebook and Tags filter a list as you type, and Enter picks the highlighted row.

Title and Text trade a line with the arrows at their right edge. Point at the Title and a down arrow appears: it moves the title to the top of the Text, as its first line, and leaves the Title empty for one you type. Point at the Text while the Title is empty and an up arrow appears: it makes the Text's first line the title. Alt+↓ and Alt+↑ do the same from anywhere in the form, and the cursor stays where it is. So from highlighted text, Alt+↓, a title of your own and Enter keep the whole text in the note. On a phone, with no pointer to hover, each arrow shows whenever it applies.

Title and Tags grow with what they hold, up to three lines; past that they scroll, and the scrollbar shows there is more. Tab into either puts the cursor at the end, ready to add to it; a click puts it where you click. Enter in them never starts a new line, and a pasted line break becomes a space.

Due shows the date and time beside a bell. The bell unfolds Cockpit's date picker, the calendar, the time columns and the quick buttons, and every pick writes into the row at once. A to-do whose date is picked before its time starts at the day start time.

The form with the date picker unfolded under the Due row: the date and time, the quick buttons, the calendar and the time columns

Create writes the note and opens it only if Open says so. Cancel, or Escape, writes nothing. A form with no title and no text creates nothing. An empty title with text takes the first line of the text as the title.

Settings

Settings › Plugins › Jot:

  • What Jot creates: a to-do or a note.
  • Notebook for quick notes: The current notebook (the one of the note you are in, the default), or any notebook, such as an inbox. Notebooks made later appear in the list once Jot has been used.
  • Notebook for notes from text in a note: The current notebook (the default), or any notebook.
  • Fill in the tags of the note you are in: Never, For notes from text in a note (default), or Always.
  • Add a back link to the note you are in: Never (default), For notes from text in a note, or Always; the form's Back link starts here.
  • Back link text: Parent {note_type}: {note_link} by default. The placeholders are Copy Note ID's, for the note you are in: {note_link}, {note_title}, {note_id}, {note_type} (to-do or note), {notebook_name}, {notebook_path} (such as Work/Projects) and {notebook_id}. So Extracted from: {note_link} works too.
  • Back link position: the first line, above the text (default), or the last line, below it.
  • Open the new note: No, In the editor, or In a new window; the form's Open starts here.
  • Pin the new note in Note Tabs: Not used (default), Pin, or Don't pin; the form's Note Tabs row starts here, and Not used shows no row.
  • Highlighted text in the form: The first line as the title, the rest as the text (default), or All of it as the text, the title empty. A title left empty still takes the first line of the text on Create.
  • In this note, for highlighted text: Replace it with a link to the new note (default), Keep the text, or Add a link after it.
  • In this note, for the typed trigger: Replace the trigger with a link to the new note (default), or Remove the trigger.
  • Typed trigger, Day start time, and Show the Jot button in the note toolbar (after a restart, since Joplin cannot add or remove a toolbar button while running).

Known limits

  • In the Rich Text editor the typed trigger does not work (no plugin code runs there), and "Add a link after it" is not offered; the shortcut and the right-click entry work, and "Replace it with a link" writes the link as HTML.
  • In the form, Alt+↑ and Alt+↓ (Option on macOS) belong to the arrows between Title and Text, so on macOS they no longer move the cursor by paragraph in the Text.
  • When the note list shows All notes, Joplin answers a new tag by selecting the note at the top of the list, which is the note Jot has just created. Jot notices and opens the note you were reading again, at the same scroll position and caret in the Markdown editor. Joplin can only do that by showing the note's notebook, so the note list switches from All notes to that notebook.

Works with Cockpit

Cockpit supports Jot from version 2.8, on desktop. A right-click on its New note or New to-do button opens Jot's form with that type and the panel's notebook, and a plain click can be set to do the same. Quick edit… in the right-click menu of its notes list opens Jot's edit mode on that note. Neither plugin needs the other.

Works with Note Tabs

With the Note Tabs plugin installed (1.1.0 or later; 1.4.0 is the current release), set Pin the new note in Note Tabs to Pin or Don't pin and the form gets a Note Tabs row. Pin adds the new note to Note Tabs' panel as a pinned tab, and the note is not opened: you stay where you were, and the tab is there for later. With Open on In editor or New window, Note Tabs also sees the note being opened, and the tab stays pinned. If Note Tabs is not installed or is turned off, the note is still created, and Jot says so once, until Joplin restarts. Plugin settings are kept per device, so on a phone the row shows only when the setting is on there too.

For other plugins

joplin.commands.execute('jot.open', args): with { mode: 'new', type, title, body, notebookId, due } it opens the form with those presets and resolves { id, opened, pinned }, or null on Cancel; with { mode: 'edit', noteId } it opens edit mode and resolves { id, changed }, the list of fields written, or null. With no arguments it behaves as the shortcut.

due (Jot 0.5.0 and later; an older Jot ignores it) is a to-do's due date in milliseconds since the epoch: the form's Due row starts on that date and time. With type: 'note' the row is greyed and no due date is written, as when you switch the form to Note.

Build from source

npm install
npm run dist

npm test runs the harness; npm run test:e2e runs the Playwright suite over an isolated Joplin AppImage under xvfb. The plugin file is publish/io.github.pmslava.jot.jpl.

Support

If this plugin is useful to you, support the work: GitHub Sponsors for monthly or one-time sponsorship, or Ko-fi for a one-off tip by PayPal or card without an account. All options: pmslava.com/support.

Credits

The idea of a note from highlighted text comes from Convert Text To New Note by ambrt. The capture use case comes from xiaofeng's request in the Cockpit forum thread. Keeping highlighted text whole in the Text comes from bwat47's request (issue 8). The date picker is Cockpit's. MIT.