PrinceLists

by Prince Lundgren
5
4
3
2
1
Score: 47/100

Description

Plain Markdown notes as todo lists in Obsidian, on desktop and mobile.

Reviews

No reviews yet.

Stats

0
stars
125
downloads
0
forks
22
days
1
days
1
days
396
total PRs
0
open PRs
8
closed PRs
388
merged PRs
97
total issues
28
open issues
69
closed issues
389
commits

Latest Version

a day ago

Changelog

Repeat an item, tag a heading or a whole list, and act on a selection from a tidier bar.

New

  • Repeat an item every few days, weeks, months or years, on the month's last day, or a set time after you tick it, with an end date or a number of times, from its card or its menu, or a dialog on mobile. A ticked repeating item stays done until its next date, then comes back open (#395, #399, #400, #405, #406, #407, #490)
  • A tag on a heading counts for every item in its section, and the list's tags property for every item in the list, in the list's and the Schedule's tag filters (#431, #432)
  • Tag a heading, or the whole list, from its menu, and see the list's tags right of its title (#438, #440, #445, #447)
  • Tag an item from its row's right-click menu, or every selected item at once from the selection bar (#387, #388, #444, #449)
  • No tag in the tag strip shows the items that carry no tag (#390)
  • Duplicate an item with its notes, from its right-click menu or a selection's More menu (#467)
  • Drag the floating + onto the list to add an item where it drops (#488)
  • The Schedule groups its items by list, with each list's folder (#422)

Improved

  • The card gives its title a line of its own, with its tags and buttons in a row under the notes (#459, #462, #464, #472)
  • The selection bar keeps Move to, Date and Delete, and puts the rest in More; Move to opens a menu of headings (#467, #469)
  • The card's tag button opens the tag field in a popover, so opening it moves nothing (#381)
  • Tags show as gray labels, a selection is marked in the accent color, and a ticked checkbox is a softer accent (#471, #473, #478)
  • A hold lasts 800 ms, as long as Obsidian's own on mobile, and a row pressed by touch shows at once (#491)
  • On mobile, the floating + hides while you type (#477)
  • A click or tap on empty space ends selecting, and on desktop so does a plain click on a row (#454, #470)
  • On desktop, a card opens with the caret at the end of its title (#463)
  • A click outside a popover, a date picker or a menu only closes it (#458, #482)

Fixed

  • A mouse hold with a new, empty item's card open no longer selects that item (#379)
  • The Header add button setting is gone, with the header's +: the floating + and Cmd+Enter already add an item (#427)

Install: in Obsidian, go to Settings → Community plugins → Browse and search for PrinceLists, or open its listing.

Install by hand instead: put main.js, manifest.json and styles.css in <vault>/.obsidian/plugins/princelists/, replacing any old files, then reload Obsidian or turn PrinceLists off and on.

The files carry a build attestation: gh attestation verify main.js --repo princelundgren/PrinceListsObsidianPlugin

README file from

Github

Obsidian with the Groceries list open, the items' tags above the list, two items ticked and fresh basil's notes open with a link and a checklist, beside the Schedule, which shows today's dated items from several lists

PrinceLists turns a note into a todo list, and the Schedule shows what's coming up across all your lists.

A quick tour

Lists

Tick, drag and add items right where they go.

In a todo list in Obsidian, two items are ticked and one is dragged up, then the floating + is dragged into the list, and the item it adds there gets a title, a day, a star and notes with a short list

Make a list

From the ribbon, a folder, or a note you already have.

Click the list icon in the ribbon Right-click a folder in the sidebar Right-click a note to turn it into a list

Find

Filter a list by text, and bring back ticked items.

In a todo list, an item is ticked and grays out, then the filter icon in the pane's header opens a field, its toggle brings back three items ticked days ago with blue checkboxes, and typing book leaves four items, three that mention it and one whose note has its letters in order, until the filter icon closes the field again

Tags

Tag items, then click a tag to see only those.

In a grocery list, lemons is opened and gets the curry tag from the tag button, picked from the suggestions, then #curry in the strip of tags above the list leaves the five items for the curry, under their headings

Select several

Hold an item, add others, and act on them all at once.

In a todo list, a row is held until it is selected and two more are Cmd-clicked to join it, then dragging one takes all three under the Admin heading, and Add star in the More menu of the bar at the bottom stars them

Notes

Every item has notes, with full Markdown and a toolbar.

Schedule

Dated items from all your lists, in one sidebar.

The Schedule in the right sidebar scrolls through dated items from several lists, grouped by list, under Today, Tomorrow, Next 7 days and the start of Later

On your phone

Made for touch, with the same lists.

Lists inside notes

Embed a list in any note, and tick it there.

```princelists
[[Hardware store]]
```

In an ordinary note, a princelists block naming Hardware store is typed between two paragraphs, with the link picked from Obsidian's suggestions, and once the cursor leaves the block the list shows in its place, with its checkboxes, a star and a New item button

Full feature list

Lists

  • Any note can be a list: make one, or turn a note with checkboxes into one.
  • Back to Markdown with Open as Markdown, or for good with Turn into note.
  • Sections come from headings: drag them, or collapse one or all.
  • A note for the list sits under its title.

Items

  • Add with the floating +, or drag the + to where the item goes.
  • Drag to reorder.
  • Star an item and give it a date.
  • Repeat every few days, weeks, months or years; a ticked item comes back open once its date has come and you next open its list or the Schedule.
  • Tags on an item, from its card or right-click menu; a tag in a heading (## Office #work) counts for its section, and one in the list's tags property for every item.
  • Select several by holding an item, or with Cmd+click and Shift+click, to move, date, tick, tag, star, duplicate or delete them at once.
  • Tick and forget: ticked items hide after a day, or the time you choose.
  • Find items by title, notes or date, and show only starred items, or archived ones too.
  • Filter by tag from the strip above the list, or show the items with No tag.
  • Duplicate an item with its notes.
  • Delete with Undo.

Notes on an item

  • Edited like a note, with Markdown shown only where the cursor is.
  • Any Markdown: links, checklists, tables and code, with a toolbar.
  • Paste from the web as Markdown.
  • Pictures: paste or drop them in.

Across lists

  • The Schedule shows dated items by day and by list, or in date order with Sort by date. The ribbon icon opens it.
  • A list inside another note can be ticked and edited there.
  • Works with Tasks: dates use the Tasks plugin's format.

Keys and devices

  • Shortcuts: Cmd+Enter adds an item, Cmd+F filters, Cmd+Shift+A shows or hides archived items, Cmd+Z undoes. Use Ctrl on Windows and Linux.
  • Right-click menus on items, headings, pictures and the list.
  • Made for touch: finger-sized buttons, and hold to select or drag.
  • Fits your theme, light or dark.
  • Settings: a folder for new lists, when ticked items hide, the tag strip, where the floating + shows, a Schedule button in each list's header, and the Schedule back in the sidebar if you closed it.

Quick start

  1. Install PrinceLists from Settings → Community plugins → Browse, and enable it. It's listed in Obsidian's community directory.
  2. Make a list with the list icon in the ribbon, or right-click a folder and choose New list.
  3. Add items with the +. Click one to add notes, a star or a date.

Already have a note with checkboxes? Right-click it and choose Turn into list. Items already ticked hide at once, and Show archived items shows them.

  1. Download main.js, manifest.json and styles.css from the latest release.
  2. Put them in <vault>/.obsidian/plugins/princelists/, where <vault> is your vault's folder.
  3. In Settings → Community plugins, turn on community plugins if Restricted mode is on, and enable PrinceLists under Installed plugins.

How a list is stored

---
princelists: true
---
Stuff for the new apartment.

## Kitchen
- [ ] cutting board
- [ ] freezer storage boxes ⏳ 2026-10-21 📅 2026-10-30

	Buy 6:
	- one for the freezer
	- five for the pantry
- [x] glass jars 1 l ✔ 2026-10-20 23:55
  • princelists: true makes a note a list.
  • tags is the list's tags, as in tags: [home, errands], set with Tag list… in the list's menu, in Obsidian's file properties sidebar (Show file properties) while the list is open, or with Edit in Markdown. Write the tags without a #, or quote it: an unquoted tags: #home is a YAML comment and gives the list no tag. Every item counts them.
  • Headings are sections, checkboxes are items, and lines indented under an item are its notes.
  • An item's date is the Tasks plugin's scheduled date, ⏳. Other Tasks fields, such as 📅, stay as they are, except that a repeating item's 📅 and 🛫 move with its ⏳ when it comes back.
  • ✔ with a time marks when you ticked an item. Tasks still sees it as done.
  • Only the lines you edit change. The rest of the note stays as you wrote it. The one exception is a repeating item coming back, which changes its own line and unticks the checklist in its notes.

The full format is in the design.

Good to know

  • Private: PrinceLists works only on notes Obsidian opens: your vault's, and on desktop a note you open from outside it. No network requests of its own, no data collected, no account. A picture linked from the web loads as in any note. What Obsidian's plugin directory notes:
    • Vault enumeration: to find your lists, the Schedule goes through your vault's list of notes, and reads only the lists.
    • Clipboard access: only when you ask. Copy image, Copy text, Cut and Copy write to it. Paste and Paste as plain text in the right-click menu read it, and what you paste with Cmd+V is read from your paste. PrinceLists never reads the clipboard by itself.
  • Obsidian Sync: turn on Sync's "Active community plugin list" and "Installed community plugin list" to get PrinceLists on your other devices. If two devices edit a list within seconds, Sync can drop one change, as in any note. Sync's "Create conflict file" setting keeps both, as extra lists.
  • A repeating item stays ticked in the file until it comes back, so until then Tasks queries and other apps show it done.
  • Renamed a list? Update the blocks that show it in other notes.
  • On iOS, a picture dropped from Photos may not reach Obsidian; paste it instead.
  • Made for Obsidian on macOS, iOS, Android and Windows. If something looks wrong, open an issue.

Contributing

Bug reports, ideas and pull requests are welcome.

License

MIT. The built main.js includes commonmark.js, entities, mdurl, @codemirror/lang-markdown and @lezer/markdown, and adapts the Tasks plugin's field patterns, under their own licenses: see THIRD_PARTY_NOTICES.