Date List

An Obsidian plugin for inserting single dates and formatted date lists, with a live-preview wizard and inline autocomplete. Inspired by, but much expanded from, the original Natural Language Dates plugin. This plugin is actively being developed, so create a GitHub issue if you have any trouble.

Features

Inline @ autosuggest

Type @ (or your configured trigger) anywhere in a note to open a predictive date suggestion popup. The suggestions update live as you type — press ↵ or ⇥ to insert, ↑↓ to navigate.

The popup is predictive based on what you type after @:

Inline @@ date list autosuggest

Type @@ (or your configured list trigger) to open a range picker that inserts a full list of dates at the cursor. Press ↵ or ⇥ to insert, ↑↓ to navigate.

Six presets appear immediately:

Each row shows the label, the date range, and the number of dates. The inserted list uses your configured format, prefix, postfix, and wiki link settings.

Quick Insert

Date List: Quick insert drops a single formatted date at the cursor. Pick from common presets or type any custom date expression.

You can also use a calendar popup:

The inserted date uses your configured default format, wiki links, and alias settings.

Insert Date List

Quickly add a list of dates according to your search criteria. The most common options are provided first: this week, next week, this month, etc.

Alternately, you can just return the next n number of days, say for example if you are going on a ten day vacation and you want to plan your itinerary.

Open the command palette and run Date List: Insert date list. The first screen shows six common range presets (this week, next week, this month, etc.) — click or press the matching number to insert immediately.

For a custom range, choose Custom… (option 7) to expand an inline date picker with four methods:

All date fields accept natural language input.

A ⚙ Configure format… button is available on every screen to set the date format, wiki links, prefix, and postfix before inserting.

Filter Dates

The Date List: Filter dates command allows you to find all instances of a specific day given the search parameters. For example, you can easily find the weekends for the next three months, or the dates of a recurring meeting you have.

Insert Calendar

The Date List: Insert calendar command inserts a markdown table for a whole month. The header row follows your configured first day of week, and each day cell uses your date format and wiki link preference.

A searchable picker lets you choose the month:

With wiki links enabled, each cell links to that day's note (e.g. [[2026-06-07\|7]]); otherwise it shows the plain day number.

Configure Date List

Every time you enter a date, you can choose from a default format or customize it on the fly. The plugin supports wiki links, aliases, and any date format you can think of.

In the plugin settings, you can customize your default preferences. For example, if you use Daily Notes, you may have a dating convention like YYYY-MM-DD, but prefer a more readable format in the alias.

In the plugin settings, you can customize your default date format preferences and trigger characters. For example, if you use Daily Notes, you may have a dating convention like YYYY-MM-DD, but prefer a more readable format in the alias.

The inline date trigger (default @) and inline date list trigger (default @@) can each be changed to any character or sequence that doesn't conflict with other plugins.

The first day of week setting (default Monday) determines where weeks begin for the inserted calendar and for the this week / next week ranges throughout the plugin.

Date List: Configure runs a wizard to set your format defaults without inserting anything — useful for changing defaults without having to insert a list first.

Keyboard navigation

All screens support full keyboard control:

• ↑ / ↓ — move between options
• 1, 2, 3… — jump to option by number
• Enter — confirm the focused option
• Escape / ← — go back
• OK button — available on every screen for mouse-only users

Known conflicts

Various Complements

The Various Complements plugin conflicts with the @ and @@ inline triggers. After you type a second character, Various Complements fires its own suggestion popup and dismisses the date-list popup.

Workaround: In Various Complements settings, make sure the match strategy is set to 'prefix'. Alternately, increase Min number of characters for completion to 3 or higher. This prevents it from triggering while you are still typing a short date expression.

Related plugins

If you like Date List, you might also like Calendar List — a companion plugin that pulls events from your macOS Calendar app and inserts them into your notes. I also made File Filter, which is a great plugin that lets you filter your notes by a search term.

Feedback and contributions

Let me know if you have any feedback or suggestions!