README file from
Github[!IMPORTANT] Notionalize is a plugin for Obsidian, not an official product of Notion. This is a personal project by Willy Brauner, inspired by Notion's ideas and the Obsidian community.
[!NOTE] The features are largely developed with AI assistance: each of them has its own
AGENTS.mdfile, its implementation notes written for coding agents. There is no warranty on the operation of all the features, they have only been tested during six months of daily work for my own use. The plugin is highly opinionated and developed for my own workflow, but every feature can be turned off in Settings → Notionalize.
Main features
Folder pages
Type /page, get a page inside the current one. /page Launch plan creates Launch plan/Launch plan.md, links it where you typed and opens it. /base creates a database filtered on its own folder, /todo a task list with its status property and a first task.
Timeline view
Plan in a base, then drag the plan. Every dated note becomes a bar: move it, stretch it, reorder it. Draw a rectangle to select a whole cascade of tasks and shift them all in one drag. Zoom from days to the whole plan, jump back to today, create a note right on a date.
Board view
Drag cards, change values. One column per status, tag or any select value. Move a card to change it, Alt-drag to copy it into another list, reorder cards and columns, hide the ones you don't need. Columns take the colors of your values.
Links in titles
Type @ in a title, mention another note. "Design review of @Website redesign" becomes a title with a live link chip, with its icon. It is a real link: it shows in backlinks and the graph, and follows the note when it is renamed.
Side peek
Open a note without leaving the base. Click any row, card or bar: the note slides in on the right, fully editable. Escape closes it, Cmd+Enter opens it in full. Desktop.
Icons, everywhere
Give a note an icon once, see it everywhere. In the file explorer, tabs, headers, bases, the quick switcher, and inside the text: links carry the icon of their note, external links the icon of their site. In light and dark.
Select chips
Colored values, picked in a click. Select properties become chips, in bases and in your notes, edited with a picker that also creates values. One color per value, shared by the chips, the board columns and your tags.
Folder notes, the Notion way
A note and its folder become one page: Projects/Projects.md, or a base Projects/Projects.base.
Also: folder-scoped bases (a base shows its own folder, new items land in it), rename the folder with its note, inline rename in bases.
And the small things
- Copy and paste cells: Cmd+C, Cmd+V on table cells, pasted into several at once.
- Tag colors: right-click a tag, pick a color.
- Media drop: dropped files go to an
_assetsfolder next to the note, images converted to WebP. - Clean search results: file name, icon and folder in the quick switcher.
- Format on save, Hide .base in links, Bases keep their own context (off by default).
Visual tweaks
Six optional touches of Obsidian's look, off by default.
| Tweak | |
|---|---|
| Grey accent | A grey accent instead of Obsidian's purple |
| Darker dark mode | A near black background in dark mode |
| Note typography | Larger headings, wider margins |
| Raised active tab | The active tab looks raised |
| Plain properties | Properties without background |
| Bases layout | Bases on the note margins, taller rows |
All features
Every feature is a toggle in Settings → Notionalize, with a link to its page. Turned off, it leaves nothing behind.
| Section | Feature | Default | Desktop only |
|---|---|---|---|
| Bases | Database header | On | |
| Bases | Hide .base in links | Off | |
| Bases | Folder-scoped bases | On | |
| Bases | Inline rename in bases | On | |
| Bases | Side peek | On | Yes |
| Bases | Timeline view | On | |
| Bases | Board view | On | |
| Bases | Copy and paste cells | On | |
| Bases | Bases keep their own context | Off | |
| Folder notes | Folder templates | On | |
| Folder notes | Folder pages | On | |
| Folder notes | Open folder notes | On | |
| Folder notes | Rename the folder with its note | On | |
| Folder notes | Clickable breadcrumbs | On | |
| Properties | Select chips | On | |
| Properties | Tag colors | On | |
| Icons | Icons | On | |
| Editor | Clean search results | On | |
| Editor | Media drop | On | |
| Editor | Format on save | Off | |
| Editor | Mentions in titles | On | |
| Visual tweaks | The six tweaks above | Off |
Installation
Notionalize needs Obsidian 1.10.2 or later (Bases), on desktop and mobile.
- Download
main.js,manifest.jsonandstyles.cssfrom the latest release. - Put them in
<your vault>/.obsidian/plugins/notionalize/. - In Settings → Community plugins, turn on Notionalize.
- In Settings → Notionalize, keep what you like.
Privacy & network
- No telemetry: Notionalize sends nothing about you or your vault anywhere.
- Website icons (off by default, Settings → Notionalize → Icons): each domain shown, from external links and
urlproperties, is sent to Google's favicon service (https://www.google.com/s2/favicons?domain=<domain>) to fetch its icon. - HEIC images (macOS desktop, Settings → Notionalize → Media drop): a dropped or pasted HEIC/HEIF image is written to the system temp folder, converted to PNG by macOS's
sipscommand, then both temp files are deleted. This is the only place the plugin uses Node's file system and runs a command. - Vault-wide reads: some features go through the vault's file list, locally: select value suggestions,
@mentions in titles (and their update when a note is renamed), folder templates, the database header and the folder-scoped bases. - Everything else stays in your vault: frontmatter,
.basefiles, and the plugin'sdata.json(feature states, settings, icons, value colors). The side peek keeps its width in the vault's local storage.
Development
pnpm install
pnpm dev # build in watch mode
pnpm build # production build into dist/
pnpm verify # lint, unit tests, build, end-to-end tests
Set NOTIONALIZE_PLUGIN_DIR (environment, or .env.local) to a vault's .obsidian/plugins/notionalize folder to copy each build there.
- Architecture: features, the scoped plugin, the feature manager,
data.jsonand its migrations, services, adding a feature. - Testing: unit, end-to-end (a real, isolated Obsidian) and manual checks.
- AGENTS.md: conventions, and the
AGENTS.mdof each feature for its implementation.
License
MIT, see LICENSE. The bundled icons (Phosphor, MingCute, Fluent UI, Tabler, Heroicons, Simple Icons) and Prettier keep their own licenses: see THIRD_PARTY_NOTICES.md.