Mappy

by hiroyaiizuka
5
4
3
2
1
Score: 58/100

Description

The Mappy plugin turns Markdown notes built from H2 headings and bullet lists into editable mind maps without introducing a separate file format or database. It provides standard map, timeline, hierarchy and balanced layouts, with changes to nodes written back to the source note. Nodes can be added, edited, reordered, reparented, collapsed and linked to notes, attachments or external pages. Maps can appear beside Markdown, open as read only embeds in other notes and export to SVG or PNG. It also supports free topics, map branches drawn from other notes and insertion into Excalidraw drawings. The plugin is desktop only, remains in beta and has been verified primarily on macOS with Obsidian 1.14, while Windows, Linux and non Japanese input methods remain untested.

Reviews

No reviews yet.

Stats

13
stars
2,287
downloads
2
forks
51
days
30
days
30
days
195
total PRs
3
open PRs
4
closed PRs
188
merged PRs
0
total issues
0
open issues
0
closed issues
1,096
commits

Latest Version

a month ago

Changelog

What's Changed

Full Changelog: https://github.com/hiroyaiizuka/Mappy/compare/0.4.10...0.4.11

README file from

Github

Mappy

English | 日本語 | Documentation

A note open in Obsidian's light theme: its Markdown on the left and the same note as a Mappy map on the right

Mappy lets you read and edit an Obsidian note as a mind map, without turning it into anything else. A plain note written with H2 headings and bullet lists is shown in one of four layouts (mind map, timeline, hierarchy, balanced), and adding, editing and moving nodes writes back to that note's Markdown. There is no special file format: without Mappy, the note is still headings and bullet lists.

0.x is a beta. It has been checked only with Obsidian on macOS desktop. Real typing with a Japanese IME, Windows and Linux have not been checked yet (see Compatibility and Known limitations). Mappy is desktop only and doesn't run on mobile. Before using it in your everyday vault, make sure you have a backup such as git or Obsidian Sync.

What it does

  • Switch one note between Markdown and a map, or put the two side by side; an edit in either shows up in the other at once
  • Add a sibling or child with Enter/Tab and type in place, drag to reorder or change the parent (the destination is shown beforehand), fold branches (folds made on a map are remembered per note, so it opens again as you left it), undo and redo
  • Show internal links, external links and images in nodes, and suggest notes and attachments after [[ / ![[
  • Color a node with one of six highlighter colors to make it stand out (right-click it and pick a color circle, or use a command). In Markdown the node's text is wrapped in <mark style="background: …;">, as the Highlightr plugin writes it, so the note shows the same color
  • Keep one of four layouts (mind map, timeline, hierarchy, balanced) per note
  • Double-click empty space to place a second or later map (a free topic), and make it a branch of the main map later
  • Write ![[Map note]] in another note to embed the map read-only. A map note's card on a Canvas shows the map too, and a double click opens the map beside the Canvas
  • Insert a map into an Excalidraw drawing, or export it as SVG/PNG
  • When another editor or an external tool (Cursor, Claude Code and so on) rewrites the file, the map updates as soon as Obsidian notices the change

Storage format

The Markdown is the single source of truth. Everything in a map is in the note's body and frontmatter; Mappy keeps none of it in files or a database of its own. Outside your notes, Mappy leaves its settings (data.json), the backups of notes taken before an input is written (exit-backups/; see "Quitting or reloading while typing" under Known limitations) and which branches are folded (how the maps are shown, folds.json), all in the plugin's folder .obsidian/plugins/mappy/, plus the inputs that could not be written on a reload or quit (in Obsidian's storage for this vault). Deleting folds.json changes no note (deleted with Obsidian closed, the maps open as they start, with nothing remembered, an inserted map's branches open down to its root's children at first; deleted while Obsidian runs, Obsidian keeps using what it remembers and writes the file again the next time it writes its memory, after a fold for example).

The root is an H2 heading, and list indentation below it makes the hierarchy. The first line of an item is the node's text; there is no separate title field.

---
mappy: true
---
## Trip plan
- Preparation
  - Packing list
- Destinations
  - Kyoto
    - [[Kyoto notes]]
  - ![[map.png]]

Mappy writes three frontmatter keys. It only handles notes with mappy: true and leaves every other note alone.

Key Value Meaning
mappy true (a YAML boolean) Open this note as a map. "Turn this note into a mind map" writes it and "Turn off mind map for this note" removes it
mappy-layout timeline / hierarchy / balanced The layout. Not written for the mind map layout (leaving it out means mind map)
mappy-topics heading text: { mindmap: [x, y], timeline: [x, y] } Free topic positions, keyed by the heading text and saved per layout. When several topics share a heading, the second and later ones are keyed heading text (2), heading text (3)… (in source order; when that string is another heading's text, the smallest unused number)
  • Mappy rewrites a note only on an explicit action: turning it into a map or back, switching the layout, adding, editing, moving or deleting nodes, and moving free topics. Opening, viewing, flipping between the map and Markdown, and changing settings don't rewrite it.
  • An edit replaces only the lines it changes. Other lines, other frontmatter keys, blank lines and line endings stay as they were.
  • This list format applies when the note's top-level headings are all H2, or there are none. A note with H1, H3 or other headings is shown as a heading hierarchy (H2→H3→H4…) as it is, and is not converted automatically. "Change to list format" in the context menu converts it explicitly, and undo reverts it.
  • Headings are read as Obsidian reads them. A line of text followed by === / --- (a setext heading) is a heading only when the text is a single line (including a single line with <br>). === / --- under text of two or more lines is read as body paragraphs, not a heading, as Obsidian's reading view and outline do (with ---, a paragraph and a horizontal rule). Mappy 0.3.8 and earlier showed this form as a heading node too, so in such notes that node leaves the map and becomes body text of the node above, and the nodes below it may get a new parent. A note whose only heading besides H2 was this form of === now opens as the list format, and the list items that used to be body text appear as nodes. The note's text doesn't change. To keep the node, make the heading text a single line in Markdown (use <br> for line breaks), or rewrite it as ## Heading. %%…%% comments are also read as Obsidian reads them: inside one line they are part of that line's text, and across lines they count as a blank line (a Heading and === right below a line holding only %%note%% are two lines of text, so they are not a heading; with a blank line between them, they are).
  • Numbered lists and task lists don't become nodes, but their text is kept as it is. A node shows its text and the links and images in its body. Body text (continuation lines before any child list) is not shown in the map; use "Edit body and links" in the context menu for it.

Installation

Mappy can be installed on the desktop version of Obsidian (1.8.7 or later; see Compatibility for what has been checked).

  1. Open Obsidian's Settings and choose Community plugins. If Restricted mode is on, turn it off first
  2. Click Browse, search for Mappy, and choose Install
  3. When it finishes, choose Enable

When a new version comes out, check for updates on the Community plugins screen to bring it in.

To install by hand, put the three files main.js, manifest.json and styles.css attached to a version on Releases in your vault's .obsidian/plugins/mappy/, then enable Mappy in the community plugins list (with Restricted mode off; if Mappy isn't listed, reload the list or restart Obsidian). The repository's source code does not work as it is.

For a step-by-step guide to using Mappy, see the documentation.

Basic usage

Opening and switching

Use the command palette, the ribbon icon on the left, or a file's context menu. No default hotkeys are registered; assign them in Obsidian's settings if you need them.

Command What it does
Create new mind map Creates a note with mappy: true and an H2 root in the folder from the settings, and opens it. The file is named "Untitled mind map" and the root "Central topic" (written into the note as ## Central topic). Tab there adds a "Main topic", and Tab on that a "Subtopic"
Turn this note into a mind map Writes mappy: true into the open note's frontmatter and opens it as a map (also in the file's context menu)
Open mind map Opens a mappy: true note as a map. The ribbon icon on the left does the same, but when the open note is not a map (or no note is open) it creates and opens a new map, as "Create new mind map" does (the open note's content is not changed; pressed on a Markdown note, the new map opens in that note's tab). On an old-format note with mappy-layout alone it creates nothing and points to "Turn this note into a mind map"
Open mind map beside Markdown Puts the map and the standard editor side by side. Run from a Markdown note, the map is on the left and the editor on the right. Run from a map, the Markdown opens on the left
Switch between map and Markdown Flips the same pane between the two. The Markdown side scrolls to the selected node's line
Turn off mind map for this note Removes mappy, mappy-layout and mappy-topics and goes back to Markdown, keeping the body
Change current map to list format Converts a heading-hierarchy note to an H2 root and a list (undo reverts it)
Search and insert a map Searches for another mappy: true note and adds it as an ![[Other map]] item at the end of the selected node's children. With nothing selected (after clicking empty space to clear the selection), places it near the main map as a ## ![[Other map]] free topic at the end of the note. Only while a map is active
Insert current map into Excalidraw drawing See Adding to Excalidraw
Export current map as SVG or PNG See Exporting to SVG or PNG
Rescue unsaved drafts Lists the inputs that couldn't be written when Obsidian reloaded or quit, and the backups of notes taken before inputs were written ("Quitting or reloading while typing" under Known limitations); the one you choose is saved, after a confirmation, as a new note in the Mappy Recovery folder at the top of the vault. The original note, the kept input and the backups are not changed. An input or a backup you no longer need can be discarded from its line, after a confirmation (a backup goes to the system trash)

A mappy: true note opened from a link or the file explorer also opens as a map. A pane switched to Markdown with "Switch between map and Markdown" stays Markdown when the same note is opened again. A map tab behaves like a Markdown tab: a note chosen from a link in the map or from the file explorer opens in that tab (Cmd/Ctrl+click for a new tab; pin the tab to keep it), and back/forward return to the map. [[#Heading]] and [[Note#^block]] select the node at that position, and when you move to another note while editing a node's text, what you typed is saved first. Escape on a node doesn't move focus to the neighboring tab. Hovering over an internal link in a node with Cmd/Ctrl held shows Obsidian's page preview of the linked note, as in the Markdown editor (in map tabs, embeds and called branches alike; links are resolved from the note they are written in). Whether Cmd/Ctrl is needed can be changed under Settings → Core plugins → Page preview → Mappy. No preview shows while you are typing in a node or dragging or panning the map. While a map is active, Obsidian's file commands such as "Copy current file path from vault folder" and "Delete current file" act on the map's note, not on the note next to it. Click the note name at the top of the map (the title) to rename the note there, as in Markdown (Enter or clicking elsewhere confirms it, Escape restores the old name; the command "Rename file" also starts editing the title; checked on Obsidian 1.14.4). Mappy 0.4.8 and earlier couldn't rename from the title, and the tab title ended in "· map" (now it is just the note name; the tab icon tells a map from Markdown).

On the map

The canvas fills the view, with floating buttons: the layouts in the bottom-left corner, the gear (a popover of three items) in the top-right corner, and zoom in the bottom-right corner.

Action How
Gear The gear in the top-right corner opens a popover below it with just three items: Switch to Markdown (Open the note in this tab), Search and insert a map (Insert another map) and Export (Save as SVG or PNG). ↑↓ move, Enter runs, and Escape, a click outside or pressing the gear again closes it. Node actions are on the keys below and in the context menu; everything else is in the command palette
Right-click Right-click a node to open Mappy's card: color circles at the top (No color and six colors), then Edit body and links and Add image, and below a line Delete (the same as Delete/Backspace). A heading note also offers Change to list format (a file name standing as the root offers no Delete). Delete/Backspace on the card also deletes. A node of an inserted map offers only Open original map and Collapse (Expand on a folded branch); empty space offers only Add topic. ↑↓ and Tab move, ←→ move along the color circles, Enter/Space run. Escape, a click outside, scrolling or zooming the map, or moving to another tab or window closes it. After Escape, a scroll or a zoom the focus is back on the node; after moving to another window it is on the node when you come back (a click outside or another tab keeps the focus where it went). The card is the same whatever Obsidian's native menus setting says. Editing text, adding a child or sibling, moving and undo/redo are not on the card: use the keys in this table, a double-click or a drag
Moving the selection ↑/↓ in display order, ← to the parent, → to the first child. Clicking empty space clears the selection (dragging the background doesn't), and the arrow keys start again from the main root. Undo and redo work with nothing selected
Adding a sibling/child Enter/Tab with a node selected. An input opens with a provisional name selected: "Main topic" for a node right under the root (of the map or of a topic), "Subtopic" further down. Typing replaces it (Enter without typing keeps the name, Escape right away cancels the addition, and Escape after typing cancels only the typing). A topic from double-clicking empty space or from the context menu (and a topic made with Enter on a topic's root) works the same way with "Topic". The provisional name is written into the note as it is, in Japanese (メイントピック, サブトピック, トピック) when Obsidian's language is Japanese
Editing text Double-click or F2. Enter confirms, Shift+Enter breaks the line inside the node (saved on one line in Markdown, like Hot<br>springs), Escape cancels. The input widens with the text and wraps at the same width as the confirmed node (a line with link or emphasis syntax, a URL or runs of spaces may wrap at a different place than after confirming)
Adding children in a row Tab while editing text confirms and adds a child
Link and attachment suggestions [[ or ![[ while editing text. While suggestions are shown, Enter/Tab picks a suggestion first
Moving up/down Alt (Option)+↑/↓, or drag the node (see Reordering and changing the parent)
Reordering and changing the parent Drag the node. A placeholder node and line show the destination beforehand; Escape puts it back
Deleting Delete/Backspace (with its branch). Afterwards the sibling above is selected, or else the sibling below, or else the parent (in source order, also in the balanced layout). Clearing a free topic's title selects the topic above or below, or else the main root. The items of a main map without an H2 and the topics are treated as separate sequences; when nothing is left in the same sequence, the nearest node is selected. Undo brings it back
Folding Space, or the round − that appears at a branch's fork. A folded branch shows how many descendants are hidden. Branches folded and unfolded on a map tab are remembered per note: they stay as they were when you open another note in the same tab and come back, switch to Markdown and back, or restart Obsidian (and they follow the note when it is renamed or moved inside Obsidian). With one note open in two tabs, each tab keeps its own folds while open, and the next opening shows the tab changed last
Editing body and links / adding an image Right-click the node (see Right-click above)
Coloring a node Right-click the node and press a color circle at the top: No color or one of six colors (yellow, orange, red, green, blue, purple). Hover a circle for its name; the current one has a ring. The commands "Color selected node: …" and "Remove color from selected node" can take hotkeys. Markdown gets the node's whole text wrapped in <mark style="background: #FFF3A3A6;">…</mark> (Highlightr's inline style and its default colors), nothing else. The same written by hand in Markdown, or ==…== around the whole text, shows as a color too; a mark around part of the text stays a highlight inside the text. A block id at the end of the line ( ^id) stays outside the mark. The dark theme draws each color darker so the text stays readable. The text input does not show the mark, and renaming keeps the color. Undo takes it back in one step
Undo/redo Cmd/Ctrl+Z / Cmd/Ctrl+Shift+Z. Right after adding a node (Enter/Tab, or a double-click on empty space), Cmd/Ctrl+Z in its input removes the node, as Escape does, and Cmd/Ctrl+Shift+Z brings it back (a topic from a double-click comes back without the position you clicked). Once you have typed in the input, Cmd/Ctrl+Z first undoes the typing
Panning and zooming Drag the background, scroll or pinch, scroll with a modifier key, or the buttons in the bottom-right corner
Inserting another map Make a node's text just ![[Map note]] (the same as "Search and insert a map"; ![[Note#Heading]] inserts only what is under that heading; a free topic heading ## ![[Map note]] works too, and that topic becomes the inserted map). The node becomes the inserted map's root, and the inserted map's branches line up to the right, looking the same as the current map's and in the same layout (down to the root's children when first opened). The inserted part is read-only (in a muted text color; an ![[…]] node has a link mark in front): you can select and fold it, and open the original map (double-click, or "Open original map" in the context menu). The ![[…]] node itself can be edited, moved and deleted as usual, and deleting it removes the inserted branches with it. Insertions of the map itself, and insertions inside an inserted map, stay links

If you switch to another app or window while typing in a node's input (the one opened by double-click, F2 or Enter/Tab), the input stays open and what you had typed so far is saved to the note (if the save is refused, the input shows an error and nothing is written to the note. What happens when you leave in the middle of IME composition, and how it behaves when actually switching apps, have not been checked. The "Edit body and links" dialog does not save when you leave). Come back and press Enter to close it; anything you typed after coming back is saved then. Escape after coming back cancels only what you typed after leaving, and what was saved when you left can be undone with Cmd/Ctrl+Z.

If you close the map tab or another window, or disable Mappy, with the input still open (without pressing Enter or Escape), what you are typing is saved to the note too. It is the same as a Markdown tab not losing typed text, and the same as moving to another note (a link, the file explorer, back/forward). Text still being composed with an IME is saved as it appeared in the input (closing in the middle of real IME typing has not been checked yet). Even if the input shows an error, closing tries to save once more, and if it can't, tells you why with "Couldn't save the text being edited." (for example, when the node being edited itself changed on the Markdown side; the note then keeps the Markdown side's content). To discard what you typed, press Escape before closing. Quitting Obsidian or reloading the window saves it too (it is written after the reload or at the next launch; when it can't be, see Known limitations).

Hovering over a node's body shows no tooltip with its title or its source path (so as not to cover the input or the node right below). The fold buttons and the buttons at the edges of the view show tooltips as before. The source path stays in exported SVG as the node's tooltip. With the focus in the map, F2 is the map's key: it starts editing the selected node (it does nothing in a node's input or on the map's buttons). With the focus outside the map, for example in the map tab's title, F2 does what Obsidian's default hotkey ("Rename file") does and selects the note name in the title, as in Markdown (checked on Obsidian 1.14.4; in Mappy 0.4.8 and earlier, F2 outside the map did nothing while a map was active). The input in a node is Mappy's own, not Obsidian's standard editor. Besides note names, paths and aliases, the suggestions include attachments in the vault such as PNG, SVG and PDF.

Layouts

Choose one in the bottom-left corner. Switching only writes mappy-layout; the body doesn't change.

  • Mind map: grows to the right, connected by right-angled lines with some space. mappy-layout is not written
  • Timeline (timeline): puts the first level along a horizontal axis and grows the branches below it alternately up and down. When consecutive first-level items are on the same side and the next item has branches, the next item is placed well apart from those of the previous item's branches that reach the height where its own branches go, and closer to branches farther from the axis
  • Hierarchy (hierarchy): puts the root at the top and grows downwards, lining up children of the same parent on one row (for org charts and issue trees)
  • Balanced (balanced): puts the root in the middle and splits the first level right, left, right, left in Markdown order. There is no way to choose the side by hand

Free topic positions are saved per layout and kept when you switch (a topic without a name yet also stays where you put it). For switching while dragging, see Known limitations.

Free topics

The note's first heading section is the main map, and each later top-level section (## ) is a free topic placed near it.

Action How
Adding Double-click empty space, or "Add topic" in the empty space's context menu. A ## Topic section is created where you clicked, with "Topic" selected in an input to type over (Escape right away cancels). Running "Search and insert a map" with nothing selected places a ## ![[Other map]] topic near the main map (in a note with no content, either way that section becomes the main map)
Moving Drag the topic's root. The position is saved in mappy-topics. Topics with the same heading (such as the same map inserted twice) move separately
Making it a branch of the main map Carry the topic next to a node of the main map and drop it. The section becomes a list under that node
Detaching a branch Drag a branch of the main map to empty space with no nodes and drop it. It becomes a new ## section at the end of the note
Moving the main map Drag the main root. Topics keep their place on screen
Deleting Delete, or "Delete topic" in the context menu

All of these can be undone. A note with no headings gets a root showing the file name that holds everything together.

Settings

Obsidian's Settings → Mappy has four items. Changing them doesn't rewrite any note.

  • Theme: Follow Obsidian (default) / Light / Dark. Applies only to the map view
  • Default layout for new maps: the value "Create new mind map" and "Turn this note into a mind map" write to mappy-layout. Notes that already exist keep their layout
  • Folder for new maps: a path relative to the vault. Empty follows Obsidian's "Default location for new notes", and / is the vault root
  • Layouts in the bottom-left corner: chooses the layout buttons shown in the map's bottom-left corner (by default the mind map, the timeline and the hierarchy; turn Balanced on to show it too). The mind map and the layout chosen as the default for new maps can't be hidden (choosing a hidden layout as the default shows its button as well). Each layout has a line of its own with its switch on the right, and the ones that can't be hidden say "Always shown". When an open note's mappy-layout is a hidden layout, that note still shows its button. This is a display setting, not a way to turn features off: saving and restoring mappy-layout, the commands, embeds and inserting into Excalidraw don't change. Up to 0.4.2 all four were shown by default. After updating to 0.4.3, if you haven't changed any Mappy setting since 0.2.0, the Balanced button leaves the bottom-left corner (turn it on in the settings to bring it back). If you have changed any setting since 0.2.0, your saved choice stays as it is

Embedding in another note

Writing ![[Map note]] or ![[Map note#Heading]] shows a read-only map in reading view, Live Preview and hover previews. The layout is the original note's mappy-layout, the frame has a fixed height, and inside it you can only fold and unfold branches. Branches you unfold (or fold) in an embed stay that way when you edit the original note as a map, switch its layout or undo. When the original note is rewritten on the Markdown side or by an external tool (including when you keep working on the map right after), folding may reset on branches of nodes that share a name or have an empty title. "Open in map" in the top-right corner opens the original note as a map. A note without mappy: true, and a block reference (#^id), stay Obsidian's usual embeds.

When you put a note with mappy: true on a Canvas, its card (a file card) shows a read-only map filling the card too (a card with #Heading shows only what is under that heading; you can fold and unfold branches in it). Double-click the card, or press "Open in map" in its top-right corner, and the note opens as a map beside the Canvas; what you change there shows up on the card. If the note's map is already open somewhere other than the Canvas's own row of tabs (a split beside it, a sidebar or another window), that one comes to the front instead of a new one (a map tab in the Canvas's own row of tabs isn't used; a new one opens beside). A double click on a fold button or a link inside the card does only what that button or link does, and opens nothing beside. Clicking a link to a note inside the card turns the Canvas's tab into that note, as with Obsidian's usual cards. On a map's card, a double click doesn't start Canvas's Markdown editing (the "Edit" item in the Canvas menu that appears above a selected card still does). A card of a note without mappy: true stays Obsidian's usual card. A card with a block reference (#^id), and the cards of a Canvas embedded in a note or shown in a hover preview, are out of scope and are built to stay usual cards (not checked in the app). Checked with Obsidian 1.14.4. In Mappy 0.4.9 and earlier, a map note's card showed the note's text as it is, and a double click started Markdown editing.

Adding to Excalidraw

With the Excalidraw plugin enabled, there are three ways.

Method Result
Drop a mappy: true .md onto the canvas while holding Option (Alt) Inserts the map as native Excalidraw elements (rectangles, text, lines, images), in one group, with the root linking to the original note
The command "Insert current map into Excalidraw drawing" Inserts into the drawing that was last active, with the current layout and folding
Excalidraw's "Insert Interactive-Frame" (by default, drop while holding Ctrl on a Mac or Shift+Ctrl on Windows, then choose "as Embeddable" in the dialog) Shows the mappy: true note inside the frame as a live Mappy view you can edit

A map inserted as native elements is a snapshot that doesn't sync with the original note. Dropping without a modifier key (which makes a link) works as Excalidraw normally does. When you drop a mappy: true note from Obsidian's file explorer onto a drawing with one of Excalidraw's own inserts, Mappy fits the result to the map. Which modifier key gives which insert is an Excalidraw setting, and Excalidraw shows a hint while you drag (by default, on a Mac: Shift for "Insert Image", Shift+Ctrl for "Insert Image @100%", Ctrl for "Insert Interactive-Frame"; on Windows: Shift for "Insert Image", Ctrl+Alt for "Insert Image @100%", Shift+Ctrl for "Insert Interactive-Frame"). For a single note, "Insert Image" and "Insert Interactive-Frame" open a dialog; choose "as Image" or "as Embeddable" there. Inserted as an image ("Insert Image @100%" and a drop of several notes included), the note becomes an SVG image of the map instead of an image of its text (<note name>.svg is created where the drawing's attachments go, with a number added if the name is taken, so each insert adds one file; the image links to the original note and is drawn in the light theme, which also reads on a dark drawing). This image is also a snapshot that doesn't sync with the note. An "Insert Interactive-Frame" frame (the table above) takes the map's proportions and loses its border. In 0.4.9 and earlier, with the same drawing also open in another pane, an image of the note's text could be left under the map's image. Checked on macOS with Obsidian 1.14.4 and Excalidraw 2.29.0.

Exporting to SVG or PNG

With a map open, run "Export current map as SVG or PNG" and choose a format. The map is saved as <note name>.svg / .png in Obsidian's attachment folder, with the layout, folding and theme colors you are looking at (a number is added if the name is taken). The original note isn't rewritten.

  • The SVG holds the nodes as HTML (foreignObject). Browsers and Obsidian show it, but some SVG editors and previews, such as Inkscape and Illustrator, may not show its content. Images from the vault are embedded in the SVG file (it doesn't refer to separate files). An image that can't be read becomes alternative text, keeping the node
  • The PNG draws the same SVG on your device at twice the resolution. A large map is scaled down to fit the device's canvas limit
  • Fonts are not embedded. Text widths and wrapping depend on the fonts where the file is opened, while node boxes keep the size they had when exported
  • Where this SVG can't be redrawn as an image, PNG isn't offered and only SVG can be exported (the export dialog says so)

Compatibility

Environment Status
macOS desktop, Obsidian 1.14 Checked (main actions, by automation and by eye; keeping inputs that couldn't be written, the rescue and the backups taken before a write were not checked with 1.14, see Known limitations)
Windows and Linux desktop Not checked
iOS and Android Not supported. Mappy is desktop only (isDesktopOnly in manifest.json), so Obsidian doesn't offer or load it on mobile. If your vault's .obsidian folder is synced between devices (Obsidian Sync with plugin sync on, iCloud and so on), the version your desktop installs reaches the phone as well, but from 0.4.1 Obsidian on mobile doesn't load Mappy (0.4.0 and earlier could be installed on mobile). Synced or not, map notes stay plain Markdown and nothing in them changes
Obsidian 1.8.7 to 1.13 Can be installed on 1.8.7 and later, but not checked in this range (except what Known limitations says was checked with 1.13.7 under "Quitting or reloading while typing")
Interface language Japanese when Obsidian's language is Japanese, English otherwise (command names, menus, settings and notices, and the provisional names Mappy writes into notes: Main topic / メイントピック, Subtopic / サブトピック, Topic / トピック, and the new map's root Central topic / 中心トピック; the new map's file name Untitled mind map / 無題のマインドマップ follows it too). English was checked on macOS only for command names, buttons, the gear popover, context menus, the settings tab, Subtopic, Main topic, Central topic and one refusal message; not every notice

Known limitations

  • Input methods (IME) have not been fully checked. Mappy is built not to break text that is still being composed. With 0.3.7 there is a report that a Japanese IME on macOS was tried by hand without problems, but there is no evidence (a recording, the Markdown before and after), so it can't be called checked. With a build containing the 0.4.5 fixes, there is also a report that pressing Enter while candidates are shown and pressing Tab during conversion were tried by hand with a Japanese IME on macOS without problems, and a report that live conversion also worked, again without evidence. Other operations, other versions, IMEs on Windows and Linux, and IMEs for languages other than Japanese, such as Chinese and Korean, have not been tried. If confirming a conversion adds a node or drops characters, you can fix it on the Markdown side.
  • A colored heading is not found by Obsidian's own heading links. Coloring a heading node puts <mark …> into the heading's text, and Obsidian then no longer finds it with [[Note#Heading]] or ![[Note#Heading]] (in Markdown, the page preview, and embeds of notes that are not maps). Mappy's own embeds, inserted maps and links that open the map still find it by its text without the color. Removing the color brings Obsidian's links back.
  • Undo history is separate from the Markdown editor's. The map keeps a history per note and discards it when it detects a change on the Markdown side or from outside (after that, earlier actions can't be undone with Cmd/Ctrl+Z (pressing it does nothing), and undone actions can't be redone). Switching the layout in the bottom-left corner doesn't discard it, and actions before the switch can still be undone (the result stays in the layout you switched to). Free topic positions are saved per layout, so undoing a move of a topic made in another layout doesn't change what the current layout shows (Cmd/Ctrl+Z looks like it did nothing, but it went back one step). Switching the layout more than 256 times after an action may clear the undo (and redo) history all at once. Cmd/Ctrl+Z on the Markdown side works on the editor's own history.
  • Folding in inserted maps: in a map inserted into the current map (the branches to the right of an ![[Map note]] node), after you unfold or fold the branch of a node that shares a name or has an empty title (such as a node with only an image), when the inserted note is rewritten on the Markdown side or with an external tool (as in the next item, "Folding after an external change"), that branch's folding may go back to how it was when the map was opened, and the node's selection may be cleared. Also, when one note has insert items written exactly the same way (such as two lines of - ![[Map note]]), temporarily editing one of them on the Markdown side and then restoring it may return the folding of that item's whole inserted branch to how it was when the map was opened, and clear the selection inside that branch.
  • Folding after an external change: when the note is rewritten on the Markdown side or by an external tool, folding and selection may be cleared on nodes that share a name or have an empty title (such as a node with only an image), because Mappy doesn't guess which node is which.
  • Remembered folds: folds and unfolds are written down together once 1 second has passed since the last one (while you keep folding, within 10 seconds of the first). The command "Reload app without saving" (app:reload) may lose the ones not written down yet (the map opens as it was before them). A branch is known by the titles from the top of the note down to it (same-named siblings by their order from the top; an empty title counts as a name), so if titles, order or parents change on the Markdown side or in an external tool while the map is closed, the branch may open as it starts instead of as remembered, or a fold may land on another branch of the same name. Only folds made on map tabs are remembered; folding in an embed or a Canvas card is not (they start as usual each time). A note renamed or moved outside Obsidian (in Finder or by a sync tool, including while Obsidian is closed) may lose its remembered folds. A folds.json brought in from another device by a sync such as iCloud is not read again while Obsidian runs: the next time this Obsidian writes its memory (after a fold, after an edit on the Markdown side, and so on), it writes its own folds over it. Folds are remembered for up to 1,000 notes and 4 MiB; beyond that, the notes not folded in or shown as a map for the longest time are forgotten first (they open with nothing remembered).
  • Conflicts with external changes: if the Markdown side or an external tool rewrites the note while you are typing, Mappy refuses to save rather than overwrite with old content, and keeps your typing. After the map updates, press Enter again to confirm. When several nodes share a name, or the node being edited itself changed outside, and so on, Mappy refuses rather than guess.
  • Quitting or reloading while typing: if you quit Obsidian or reload the window (the command app:reload) with a node's input open, what you are typing is saved to the note too. It isn't written at that moment (a write cut off there can leave the note empty); it is written when Mappy loads next (after the reload, or at the next launch). If other lines changed in the meantime, only your edit is written. It isn't written when the node itself (or the text right next to it) changed on the Markdown side, when nodes with the same name make it unclear where the change was, when a note over 262,144 characters (counted in UTF-16 units: most emoji count as two or more) or a free topic's rename saw any change in the meantime, when the note can't be found, when the input is more than a day old (for example, Mappy was disabled meanwhile), or when the write is refused (for example, the note changed between reading it and writing). It also isn't written when the note got shorter than it was when you typed (other lines deleted or a title shortened included), because that can't be told apart from a write that stopped and lost the end of the note; for the same reason, nor when both the last line and the line before it were changed, a line was added higher up than right above the last line and the last line changed, the last node was moved up, or the last line was joined to the one before. Before an input is written, the whole note as it is then is saved as a backup in the plugin's folder, exit-backups (.obsidian/plugins/mappy/exit-backups/), and read back to check it; then the input is written (a notice says "Wrote … A backup of the note from just before the write is kept"). It isn't written when the backup can't be saved or checked, when the backup folder holds files that aren't Mappy's backups (half-written ones included), or when a record of an earlier write that didn't finish is there. The backup folder holds at most 10 MiB in all; once it is full, inputs stop being written (they can still be rescued). Discarding backups you don't need in the list of the command "Rescue unsaved drafts" makes room, and the inputs held back are written the next time Mappy loads (after a confirmation, Discard moves the backup file to the system trash, or to the vault's .trash folder when the system trash can't be used). A backup whose input is still kept is the record that keeps that input from being written again, so it can't be discarded until that input is. The notice for a full folder points to these steps too. Mappy never deletes backups by itself. Files in the backup folder that aren't Mappy's backups (half-written ones included) can't be discarded from the list; open exit-backups in Finder, for example, to look at them (Finder hides .obsidian by default). Backups don't guarantee nothing is lost: Obsidian Sync, deleted files, uninstalling the plugin (the backups go with the plugin's folder), OS failures, power loss, not waiting for writes to reach the disk, clearing the browser data and other devices are not covered. An original text that is already lost can't be brought back. For an input that kept no original text, the backup is the note as it was when the input was written, not a text lost before that. If you go back to an earlier version of Mappy, it doesn't read the backups and may write inputs that were held back by its own rules (to go back, disable Mappy, move exit-backups out of the vault and set aside the inputs not written yet first; there is no way to set them aside yet, though rescuing an input to a separate file and then discarding it takes it out with its content kept). An input that isn't written is kept, not dropped: each time Mappy loads it tries again (and once it can be written, for example after you put the note's earlier text back, it is written then, with a notice saying so), and while it can't, a notice that stays until you close it says "Couldn't write "(your text)" in (note), which was being edited when Obsidian reloaded or quit." and what is kept, at every load. What is kept is the title you typed and the planned change, and for a note of 262,144 characters or less the note's text as it was then too (not for a longer note, which keeps nothing to bring the whole note back from). For an input that couldn't be planned because the note had already changed, only the title you typed and the reason are kept (neither a planned change nor the note's text). The command "Rescue unsaved drafts" saves what is kept, or a backup, as a new note (<original note> <date time> <id>.md) in the Mappy Recovery folder at the top of the vault (from a backup, the whole note just before the write goes in; a backup file that can't be read is listed by its path alone). The note's text goes in a code block, so the rescued note is not a map and the original frontmatter has no effect. Rescuing doesn't change the original note, and nothing is put back into it automatically (copy from the rescued note by hand to put it back). The kept input stays after a rescue and the notice keeps showing at every load (rescuing again makes another file with the same content; the same input can be rescued up to 20 times, after which the old rescued files have to be deleted first). An input you no longer need can be discarded in the same list (after a confirmation, that input alone goes, and its notice stops from the next load; it can't be brought back; the original note and the other inputs and backups aren't changed). Why a note can be left empty when the page ends during a write is not fixed. When Obsidian's local storage is short of room, the input is kept without the note's text, so it isn't written if the note saw any change in the meantime, whatever its length (with the same notice). The note's text can then be taken, without notice, even from an input whose notice said it was kept. If there is room only for the newest input, inputs still waiting from an earlier reload or quit (kept ones that couldn't be written included) are dropped without notice. Items in the local storage that can't be read as inputs aren't deleted when Mappy loads, but the next quit or reload that keeps an input may overwrite them without notice (as before; not guaranteed). Kept inputs pile up unless you discard them, so several kept inputs of long notes make this more likely. Nothing is saved if the app crashes or is force-quit, or if the local storage has no room even for the newest input. Checked on macOS only. Writing after a quit or reload was checked with Obsidian 1.14.2 in a version from before the backups and the rescue were added, and with 1.13.7 in a version that has them. Keeping the inputs that couldn't be written, the rescue command, the backup taken before a write and discarding inputs and backups were checked only with 1.13.7 (not with 1.14, which Compatibility lists as checked), in cases that artificially empty the note, cut it to its first half or change it at a reload. An input that couldn't be written after a quit, and a real half-finished write, have not been seen.
  • Focus after clicking outside the map while typing: if you click the title or the Markdown next to the map while typing in a node, what you typed is saved and the keyboard focus moves to what you clicked. Clicking a place that doesn't take the keyboard focus, such as the breadcrumbs next to the title, the "⋯" button or the status bar, also saves what you typed, but the focus goes back to the node in the map.
  • What can't be a node: numbered lists and task lists. In the heading format, H6 is the deepest level (the H2-and-list format has no depth limit).
  • Link suggestions: not Obsidian's standard suggestions, only note names, aliases and attachments. No PDF previews or annotations.
  • Embeds and snapshots: an ![[Map note]] embed and the map on a Canvas card are read-only (make changes in the original note's map), and native elements inserted into Excalidraw don't sync with the original note. When you disable Mappy and enable it again (updating included), the cards of a Canvas that is open stay Obsidian's usual cards (they are built to come back when you open the Canvas again or the note changes, but that hasn't been checked in the app). Cards of one note with different headings, stacked at nearly the same place and size, stay usual cards too.
  • Maps inserted into Excalidraw as images: turning into the map's image has been checked only for Excalidraw's insert on a drop from Obsidian's file explorer (drags from elsewhere in Obsidian, such as search results, bookmarks or links, haven't been checked in the app). A mappy: true note inserted through the insert dialog opened from Excalidraw's commands or tool panel, or dragged in from outside the app (Finder and so on), stays an image of the note's text (checked in Excalidraw's source, not in the app). In the map's image, a short node's text can wrap onto two lines ("b1" as "b" and "1", for example; it is one line in the map view). Within a minute after a drop of a map note that made nothing to replace (a drop without a modifier key, a cancelled insert dialog, and so on), inserting a map note as an image with another drop can make two map images and two attachments (not checked in the app).
  • Large notes: showing and editing 2,000 nodes has been checked, but panning and zooming slow down on a deep branch that is one long chain.
  • Several windows, or several panes on the same note: this works, but typing in two of them at once is handled as the conflict above.
  • Switching and changing the view while dragging: when you switch the layout in the bottom-left corner while carrying a topic or the main map (for example with another finger on a touch screen), fitting the whole map waits until you let go, but this, and saving when you then let go, haven't been checked on touch-screen devices yet. Pressing the zoom or fit buttons with another finger hasn't been checked on touch-screen devices either.
  • Indentation that mixes tabs and spaces: when the indentation of one list mixes tabs and spaces, Obsidian itself reads the same note in two ways. The map draws the same levels as Live Preview (the view of the Markdown being edited), but in reading view, and in features that use the list structure Obsidian read, such an item may appear at another level, or the next item may join the previous item's text and seem to disappear. The map keeps reading as Live Preview does, not as reading view does. Pressing Tab/Shift+Tab in the Markdown editor in a list indented with spaces (Obsidian inserts tabs by default) produces this. To avoid it, indent each list with either tabs or spaces, not both (then adding and moving nodes in the map writes items with that list's indentation, and a branch moved from a list indented the other way is rewritten to match where it goes. In a list without indentation Mappy follows the note's other lists (spaces if the note has both tabs and spaces), and in a list that already mixes them it writes spaces. Tabs pasted into body text, and the contents of code blocks, are written as they are). To fix lines that already mix them, retype the leading indentation on the Markdown side.
  • mappy-topics is a nested value, so it isn't meant to be edited from Obsidian's Properties panel. Mappy rewrites it only when it moves topics.

Troubleshooting

Mappy doesn't bring its own format into your notes, so recovery happens entirely on the Markdown side.

Situation What to do
The map looks or behaves wrong Open the Markdown with "Switch between map and Markdown", and check or fix the text there. The Markdown is the source of truth; the map only shows it
You want to stop using Mappy Disable Mappy in Settings → Community plugins. Notes open as ordinary headings and bullet lists; frontmatter keys such as mappy stay but do no harm
You want just one note back as an ordinary note Run "Turn off mind map for this note". It removes mappy, mappy-layout and mappy-topics from the frontmatter and leaves the body as it is. With Mappy disabled, remove the same keys by hand in Properties or in Markdown
Saving is refused with "The note changed in Markdown. Update the map and edit again." or a similar message After the map updates to the latest content, press Enter again to confirm (for a drop or an added image, do it again). If it is still refused, copy what is in the input and write it on the Markdown side
You want to undo something Cmd/Ctrl+Z on the map. If the history was cleared, for example by an external change, and the note is also open in a Markdown editor, pressing Cmd/Ctrl+Z repeatedly in the editor may bring it back (later changes, from outside or from switching the layout, are undone first, and map actions from before the editor was opened are not). Otherwise, restore from the core plugin "File recovery" or from a backup
You want to remove it completely Uninstall the plugin. All it leaves in the vault are the frontmatter keys in your notes, the <mark style=…> around the text of colored nodes (it stays and shows as a Markdown highlight; remove it on the Markdown side if you don't want it) and the plugin settings in .obsidian/plugins/mappy/data.json (besides these, inputs that could not be written on a reload or quit, if any, stay in Obsidian's storage for this vault). The backups taken before inputs are written (.obsidian/plugins/mappy/exit-backups/) are in the plugin's folder too, so rescue what you need before uninstalling (the remembered folds in the same folder, folds.json, and the folds.next.json a cut write may leave need no rescue)

Network use

Mappy has no server of its own, and sends no telemetry, update checks or note content. There are no accounts or payments. It reaches outside only when a note itself refers to an image at an external URL.

  • When a node has an image ![](https://…), it is loaded for display by the same rendering as Obsidian's reading view
  • SVG/PNG export embeds only the images at such external URLs that can be fetched within 15 seconds (nothing but images is fetched)

Two features read the list of files in your vault, on your device only: the suggestions after [[ / ![[ (file names and aliases) and the search for a map to call (the notes marked mappy: true). The list is not sent anywhere. Besides these, Mappy reads the list of files in its own backup folder in the plugin's folder (exit-backups) before writing an input and when rescuing (not the list of your notes).

License

MIT License (Copyright (c) 2026 Hiroya Iizuka).

The only bundled third-party code is the Markdown parser @lezer/markdown (MIT License, Copyright (C) 2020 by Marijn Haverbeke and others). Other plugins (MarkMind, Light Mindmap) served as references for features; none of their code is included.

Similar Plugins

info
• Similar plugins are suggested based on the common tags between the plugins.
Quoth
5 years ago by Eric Rykwalder
Siteswap
5 years ago by Tim Dresser
Multi-Column Markdown
5 years ago by Cameron Robinson
A plugin for the Obsidian markdown note application, adding functionality to render markdown documents with multiple columns of text.
Copy as HTML
5 years ago by Bailey Jennings
A simple plugin that copies the selected text to your clipboard as HTML
Excel to Markdown Table
5 years ago by Ganessh Kumar R P
An Obsidian plugin to paste data from Microsoft Excel, Google Sheets, Apple Numbers and LibreOffice Calc as Markdown tables in Obsidian editor.
Marjdown shortcuts
5 years ago by Jules Guesnon
🪨 Obsidian plugin that allows to write markdown from commands
Creases
5 years ago by Liam Cain
👕 Tools for effectively folding markdown sections in Obsidian
Quiet Outline
5 years ago by the_tree
Improving experience of outline in Obsidian
Enveloppe
5 years ago by Mara-Li
Enveloppe helps you to publish your notes on a GitHub repository from your Obsidian Vault, for free!
Filename Emoji Remover
5 years ago by Yüksel Tolun
A simple plugin for the note taking app Obsidian that will rename your files to remove emojis in their names.
ExcaliBrain
4 years ago by Zsolt Viczian
A graph view to navigate your Obsidian vault
Obsidian GoLinks
4 years ago by David Brownman (@xavdid)
Turn go/links into clickable elements in Obsidian
Hard Breaks
4 years ago by Börge Kiss
↩ A plugin for Obsidian that adds functionality to force hard line breaks
Heading Shifter
4 years ago by kasahala
Easily Shift and Change markdown headings.
Literate Haskell
4 years ago by James Jensen
An obsidian plugin for integrating .lhc files into your PKM.
Blockquote Levels
4 years ago by Carlo Zottmann
A plugin for Obsidian (https://obsidian.md) that adds commands for increasing/decreasing the blockquote level of the current line or selection(s).
Table Generator
4 years ago by Boninall
A plugin for generate markdown table quickly like Typora.
qmd as md
4 years ago by Daniel Borek
A plugin for Obsidian that enables editing and compiling `qmd` Quarto files.
Awesome Flashcard
4 years ago by AwesomeDog
Handy Anki integration for Obsidian.
Dirtreeist
4 years ago by kasahala
Render a directory Structure Diagram from a markdown lists in codeblock.
Obsidian Handlebars Template Plugin
4 years ago by Sean Quinlan
This is a plugin for Obsidian adding support for the Handlebars template engine in Obsidian notes
Markdown to Jira Converter
4 years ago by muckmuck
An obsidian.md plugin, which provides a markdown to jira markup converter
Obsidian markdown export
4 years ago by bingryan
This plugin allows to export directory/single markdown to a folder. support output format(html/markdown/text)
Obsidian Mindmap Nextgen
4 years ago by VeroCloud Pty Ltd (original by James Lynch)
Create mind maps from your obsidian markdown files
Obsidian Clipper
4 years ago by John Christopher
Obsidian plugin that allows users to clip parts of a website into their obsidian daily note (or new note)
Vega Visualizations
4 years ago by Justin Kim
Create Vega and Vega-Lite visualizations in https://obsidian.md/.
Image Captions
4 years ago by Alan Grainger
Add captions to images with inline Markdown and link support. The caption format is compatible with the CommonMark spec and other Markdown applications.
Canvas Mindmap
4 years ago by Boninall
A plugin to make your canvas work like a mindmap.
Console Markdown Plugin
4 years ago by Daniel Ellermann
An Obsidian plugin which renders console commands and their output.
Advanced Slides
4 years ago by MSzturc
Create markdown-based reveal.js presentations in Obsidian
Marp
4 years ago by JichouP
Plugin to use Marp with Obsidian
ChatGPT MD
4 years ago by Bram Adams
A (nearly) seamless integration of ChatGPT into Obsidian.
Image Upload Toolkit
4 years ago by Addo Zhang
An obsidian plugin for uploading local images embedded in markdown to remote store and export markdown for publishing to static site.
Avatar
4 years ago by froehlichA
An obsidian plugin for displaying an avatar image in front of your notes.
Links
4 years ago by MiiKey
manipulate & manage obisidian links
PubScale
3 years ago by piriwata
An obsidian plugin for insert your note into a PlanetScale table
Confluence to Obsidian
3 years ago by K
import confluence space into obsidian
Recipe Grabber
3 years ago by seethroughdev
File Include
3 years ago by Till Hoffmann
Importer
3 years ago by Obsidian
Convert your data to Markdown files you can use in Obsidian. Works with Apple Notes, OneNote, Evernote, Notion, Google Keep, and many other formats.
Markdown Link Space Encoder
3 years ago by Ron Kosova
Obsidian plugin to automatically encode spaces to %20 in Markdown-style links
Markdown Blogger
3 years ago by Alexa Fazio
Allows developers to push markdown notes to their local blog, portfolio, or static site. Works with Astro.js, Next.js, and any other framework configured to render markdown pages.
Markdown Tree
3 years ago by carvah
Introducing a powerful plugin that revolutionizes directory tree creation. With its intuitive Markdown-inspired coding style, this plugin empowers users to effortlessly and swiftly construct intricate directory trees.
Auto Front Matter
3 years ago by conorzhong
Markdown to Slack Message
3 years ago by Woongshik Choi
Lovely-Mindmap
3 years ago by shaun
Build your own knowledge graph with smiles :-)
Postfix
3 years ago by Bhagya Nirmaan Silva (@bhagyas)
A postfix plugin for Obsidian
Excalidraw CN
3 years ago by Korbin Zhao
支持中文手写的 Excalidraw Obsidian 插件。A Obsidian plugin of Excalidraw supporting Chinese handwrite font.
Floccus Bookmarks to Markdown
3 years ago by mddevils
Sheets Extended
3 years ago by NicoNekoru
Plugin that adds features to tables in obsidian including merging, vertical headers, and custom css
Pickly PageBlend
3 years ago by Dmitrii Mitrichev
The easiest way to share your Obsidian notes
Recipe view
3 years ago by lachholden
View your Obsidian notes as interactive recipe cards while you cook.
Markdown table checkboxes
3 years ago by DylanGiesberts
Obsidian plugin. Allows for the usage of checkboxes inside markdown tables.
MagicCalendar
3 years ago by Vaccarini Lorenzo
An obsidian plugin that exploit a natural language processing engine to find potential events and sync them with iCalendar
Discord Message Formatter
3 years ago by Emile Durkheim
Obsidian.md plugin that lets you copy Discord conversations and perfectly formats them to Obsidian Markdown!
Markdown Image Caption
3 years ago by Hananoshika Yomaru
Generate image caption easily. Completely markdown-based.
Global Markdown Encryption
3 years ago by shlemiel
a plugin for encrypting obsidian markdowns in-memory, single password based.
Slackify Note
3 years ago by Jeremy Overman
Barcode Generator
3 years ago by noxonad
A barcode generator for obsidian.
File Cleaner Redux
3 years ago by husjon
A plugin for Obsidian to help clean up files in your vault
Autocorrect Formatter
3 years ago by b-yp
A plugin running on Obsidian that utilizes autocorrect to format Markdown content.
Highlight Helper
3 years ago by Chongmyung Park
Helper to collect highlight in Obsidian
Strip Internal Links
3 years ago by Adi Ron
A simple Obsidian plugin to strip internal links from files
Reason
3 years ago by Joshua Pham
Digest your Obsidian notes
My Bible
3 years ago by GsLogimaker
Your own customization bible in your personal vault!
Task list
3 years ago by Ted Marozzi
A simple obsidian plugin enabling better task management via lists.
GitHub Sync
3 years ago by Kevin Chin
Sync Obsidian vault to personal GitHub
Simple File Push
3 years ago by Kim Hudaya
Simple file push blog plugin
Canvas Mindmap Helper
3 years ago by Tim Smart
Quadro
3 years ago by Chris Grieser (aka pseudometa)
Obsidian Plugin for social-scientific Qualitative Data Analysis (QDA). An open alternative to MAXQDA and atlas.ti, using Markdown to store data and research codes.
Yesterday
3 years ago by Dominik Mayer
Obsidian plugin providing Yesterday journaling support
Mxmind Mindmap
3 years ago by mxmind
mxmind for obsidian plugin
Cooklang
3 years ago by Roger Veciana i Rovira
Foodiary
3 years ago by vkostyanetsky
Food tracker plugin for Obsidian
Mehrmaid
3 years ago by huterguier
Rendering Obsidian Markdown inside Mermaid diagrams.
Slurp
3 years ago by inhumantsar
Slurps webpages and saves them as clean, uncluttered Markdown. Think Pocket, but better.
Enhanced Copy
3 years ago by Mara-Li
A obsidian plugin that allows to copy in markdown in reading view or canvas read-only view, creating profile and transform the text during copy.
Mindmap
3 years ago by YunXiaoYi
An Obsidian plugin for creating Mindmaps.
Slides Extended
3 years ago by Erin Schnabel (original: MSzturc)
Create markdown-based reveal.js presentations in Obsidian
ii
2 years ago by Wilson
The main feature of this plugin is to quickly insert common Markdown code and HTML code, including Sup, Sub, Audio, Video, Iframe, Left-Center-Right Alignment, Variables, Footnotes, Callout, Anchor Points, HTML Comments and so on.
Docxer
2 years ago by Developer-Mike
🚀 Boost your productivity by previewing and converting Word files easily to markdown.
Prettier
2 years ago by GoodbyeNJN
Interactive Code Blocks
2 years ago by Student Assistenten Team Deeltaken
Spoilers
2 years ago by Jacobtread
Spoiler blocks for Obsidian
Asciidoc Reader
2 years ago by voidgrown
Obsidian plugin for reading AsciiDoc files
Dataview Serializer
2 years ago by Sébastien Dubois
Obsidian plugin that gives you the power of Dataview, but generates Markdown, making it compatible with Obsidian Publish, and making the links appear on the Graph.
Dataview Publisher
2 years ago by UD
Output markdown from your Dataview queries and keep them up to date. You can also be able to publish them.
AI Chat as Markdown
2 years ago by Charl P. Botha
Better Markdown Links
2 years ago by mnaoumov
Obsidian plugin that adds support for angle bracket links and manages relative links properly
Note Linker with Previewer
2 years ago by Nick Allison
Obsidian Plugin to find and Link notes
Marker PDF to MD
2 years ago by L3N0X
Make use of different AI models to convert your pdfs into markdown with perfect ocr, latex formulas, tables, images and more! Supports Mistral AI OCR (free) and self hosted variants!
Recursive Copy
2 years ago by datawitch
Import GitHub Readme
2 years ago by Chasebank87
Markdown prettifier
6 years ago by pelao
A markdown prettifier for obsidian
Mind Map
6 years ago by James Lynch
An Obsidian plugin for displaying markdown notes as mind maps using Markmap.
Markdown Formatting Assistant
6 years ago by Reocin
This Plugin provides a simple WYSIWYG Editor for Markdown and in addition a command line interface. The command line interface facilitate a faster workflow.
Mochi Cards Exporter
6 years ago by kalbetre
Mochi Cards Exporter Plugin for Obsidian
PlantUML
6 years ago by Johannes Theiner
Generate PlantUML Diagrams inside Obsidian.md
Extract url content
6 years ago by Stephen Solka
Plugin to extract markdown out of urls
Table Extended
6 years ago by AidenLx
Extend basic table in Obsidian with MultiMarkdown table syntax
mdx as md
6 years ago by Nikolay Kozhukharenko
Edit mdx files in Obsidian.md as if they were markdown
Markdown Furigana
6 years ago by Steven Kraft
Simple Markdown to Furigana Rendering Plugin for Obsidian
Charts View
5 years ago by caronchen
Data visualization solution in Obsidian, support plots and graphs.
Timeline
5 years ago by George Butco
Obisdian.md plugin for creating timelines
Enhancing Mindmap
5 years ago by Mark
obsidian plugin editable mindmap,you can edit mindmap on markdown file
Paste Mode
5 years ago by Jacob Levernier
Obsidian Notes plugin for pasting text and blockquotes to the cursor's current level of indentation.
Markdown Attributes
5 years ago by Jeremy Valentine
Add attributes to elements in Obsidian
Emoji Shortcodes
5 years ago by phibr0
Emoji Shortcodes - Obsidian Plugin | Adds Support for Emoji Shortcodes to Obsidian
Markmind
5 years ago by Mark
A mind map, outline for obsidian,It support mobile and desktop
ReadItLater
5 years ago by Dominik Pieper
OzanShare Publish
5 years ago by Ozan Tellioglu
This plugin allows you to publish your markdown notes with a single click directly from your Obsidian vault.
Plotly
5 years ago by Dmitriy Shulha
Obsidian plugin to embed Plotly charts into markdown notes.
Tweet to Markdown
5 years ago by kbravh
An Obsidian.md plugin to save tweets as Markdown files.
Copy as LaTeX
5 years ago by mo-seph
Quick plugin to be able to copy/paste from Obsidian/Markdown into a Latex document
CardBoard
5 years ago by roovo
An Obsidian plugin to make working with tasks a pleasure (hopefully anyway).
CookLang Editor
5 years ago by death_au/cooklang
Edit and display Cooklang recipes in Obsidian
Remove HTML Tag
2 years ago by ChenPengyuan
Immersive Translate
2 years ago by imfenghuang
Immersive Translate For Obsidian
Quarto Exporter
2 years ago by Andreas Varotsis
Export Obsidian notes to Quarto-compatible QMD files.
Copy Section
2 years ago by skztr
Obsidian.md plugin adding a Copy button to the top of Headed sections
Advanced Copy
2 years ago by leschuster
An Obsidian plugin to copy Markdown and transform it into HTML, Anki, or any custom format. Create custom profiles with versatile templates tailored to your workflow.
Arweave Uploader
2 years ago by makesimple
Hexo Toolkit
2 years ago by Xiangru
An Obsidian plugin for maintaining Hexo posts.
Markdown Timeline
2 years ago by Jiaheng Zhang
An Obsidian plugin to record the events in a Flashback timeline
Markdown Tags
2 years ago by John Smith III
Enhance your Markdown documents with custom tags. Use predefined or custom labels, customizable colors, and arrow indicators to visually track tasks and statuses.
Insta TOC
2 years ago by Nick C.
Generate, update, and maintain a table of contents for your notes while typing in real time.
Simple Todo
2 years ago by elliotxx
A minimalist text-based todo manager (Text-Based GTD) for efficient task management in Obsidian.
Chronos Timeline
2 years ago by Claire Froelich
Render interactive timelines in your Obsidian notes from simple Markdown.
MoreDraw
2 years ago by webceoboy2011
mordraw.com for obsidian plugin
Circuit Sketcher
2 years ago by Code Forge Temple
A plugin for Obsidian to draw circuits on a canvas.
Cooksync
2 years ago by Cooksync
This is the official Obsidian plugin for Cooksync, maintained by the Cooksync team. It enables automatic import of recipe data from your Cooksync account. Note that this plugin requires a Cooksync account - a paid service that makes it easy to collect recipes from almost any recipe website.
WhatsApp export note
2 years ago by JoaoEmanuell
Obsidian plugin to export notes for whatsapp
Callout Copy Buttons
2 years ago by Aly Thobani
An Obsidian plugin that adds copy buttons to callout blocks in your notes.
Sankey
2 years ago by Finn Romaneessen
An Obsidian plugin to create sankey diagrams
Attachments MD Indexer
2 years ago by Ian Inkov
Converts Obsidian canvas files to markdown index files, making canvas content searchable and graph-viewable within Obsidian.
SQLSeal Charts
2 years ago by hypersphere
Charting extension for SQLSeal Obsidian Plugin. Visualise your data!
Automatic Linker
2 years ago by Kodai Nakamura
Extended Markdown Syntax
2 years ago by Kotaindah55
Extend your Markdown syntax using delimiters instead of HTML tags, such as underlining, superscript, subscript, highlighting, and spoiler.
Title As Link Text
2 years ago by Lex Toumbourou
An Obsidian plugin to set the Link Text using the document title
ASCII Tree Generator
2 years ago by Matěj Michálek
Chat clips
2 years ago by sleepingraven
Record chat in ordinary markdown list.
Student Repo
2 years ago by Feirong.zfr
学生知识库助手(Student Repository Helper)是一个面向学生或学生家长的Obsidian 插件,这款插件旨在解决学生在学习阶段面临的资料管理难题,将学习过程中产生的各类重要资料,如试卷、笔记、关键文档、绘画手工作品等,进行系统性的数字化整合与管理,并利用 AI 助手定期进行学习分析总结。随着时间的推移,它将助力你逐步搭建起一座专属你自己的知识宝库,这座宝库将伴随你一生,成为你知识成长与积累的见证。
Advanced Progress Bars
2 years ago by cactuzhead
Obsidian plugin to create custom progress bars
PDF Folder to Markdowns
2 years ago by CrisHood
Convert a folder of PDFs into a folder of Markdown files with embedded PDFs. This plugin is useful for users who want to migrate their PDF notes from different apps (e.g., Boox) or organize their reference materials inside Obsidian.
QueryDash
2 years ago by lwx
Limitless Lifelogs
2 years ago by Maclean Dunkin
Sync your Limitless AI lifelog entries directly into Obsidian markdown files.
Reactive Notes
2 years ago by Elias Noesis
Byte Field Diagrams
2 years ago by natri0
Byte-field diagrams for Obsidian.
Markdown Calendar Generator
a year ago by Zach Russell
An intentionally simple obsidian markdown table calendar generator
Better Mind Map
a year ago by Utkarsh Raj
Obsidian plugin to for mind maps, vizualize current note as mind map.
Simple Columns
a year ago by Josie
An Obsidian plugin that lets you create easily resizable and customizable columns in your notes.
Keyboard Formatter
a year ago by Lauloque
Formats keyboard text (kbd) in your Obsidian notes quickly and consistently.
Datacore
a year ago by Michael Brenan
Work-in-progress successor to Dataview with a focus on UX and speed.
Note Minimap
a year ago by Yair Segel
Add a minimap to your Obsidian notes.
Horizontal Blocks
a year ago by iCodeAlchemy
Bring Notion-style layouts to Obsidian — with side-by-side, resizable markdown blocks that support full Obsidian syntax including images, embeds, and internal links.
GH Links Shortener
a year ago by David Barnett
Obsidian plugin to set shortened link text for pasted GitHub URLs
Table Checkbox Renderer
a year ago by Daniel Aguerrevere
Interactive checkboxes for Markdown tables in Obsidian. Toggle checkboxes in Reading Mode and instantly update your Markdown file. Supports multiple checkboxes per cell and any table layout.
SlashComplete
a year ago by Spiderpig86
Notion-style Markdown autocompletion for Obsidian.
Archivist Importer
8 months ago by Archivist AI
An Obsidian Plugin to Imort Your Vaults into Archivist
Markdown Cleaner
6 months ago by gao-qian-long
Obsidian格式化markdown插件
Math+
6 months ago by ocapraro
This is an Obsidian plugin for taking math notes using Excalidraw.
Fountain Editor
6 months ago by Chuang Caleb
Obsidian plugin for Fountain screenplay syntax formatting.
Life Tracker
6 months ago by Sébastien Dubois
Capture and visualize the data that matters in your life
draw.io
5 months ago by somesanity
A plugin for Obsidian that integrates the draw.io editor into Obsidian.
Excalidraw Extras
5 months ago by zsviczian
Companion Obsidian.md plugin hosting extra add-on optional features for the main Excalidraw-Obsidian plugin
Charted Roots
5 months ago by John Banister
Professional genealogical tools for Obsidian. Interactive family charts, geographic maps, PDF reports, GEDCOM/Gramps import-export, evidence tracking, and fictional calendar support. Built for genealogists, historians, and worldbuilders.
Square
4 months ago by Jiao Yingxing
用小方块追踪习惯与项目,周月视图纵览进度。Track habits and projects with a grid of small squares, plus weekly and monthly progress views.
Budget Planner
4 months ago by kalinichenko88
A minimalist budget planning tool for Obsidian. Create, track, and manage budgets using markdown code blocks directly in your notes.
Side-Notes
4 months ago by Fried Fishsticks
Tufte-style sidenotes for Obsidian
Tabsdown
4 months ago by grafanakibana
Create accessible, theme-native tabbed blocks for Markdown-renderable content in Obsidian.
Power Editor
3 months ago by Power Plugins
Format any note from a toolbar, selection bubble, or slash menu: WYSIWYG editing, block drag handles, image resizing, dictation, and AI edits, all staying plain Markdown.
Mobile PDF Exporter
3 months ago by Murat
One-click selectable preview PDF export plugin for Obsidian mobile and desktop.
Visual Card Writer
3 months ago by David Hurt
A visual, card-based Markdown writing interface for Obsidian.
Excalidraw Math Plotter
3 months ago by ahmeddawoud3
Plot mathematical function graphs directly onto Excalidraw canvases.
Xyls Starmap
3 months ago by xylhazlhztarr
A small little plugin for Obsidian MD to create interactive star system maps and planet-side views inside the note-taking app.
PDF to Markdown Native
3 months ago by Andres Herle Lang
rumdl
3 months ago by rvben
Obsidian plugin for markdown linting with rumdl
Just Simple Excalidraw
3 months ago by David Hurt
A local-first Excalidraw editor for native .excalidraw files in Obsidian, preserving the original's brilliant simplicity.
Sectionals
3 months ago by Aaron Bell
Edit Markdown by structure
Excalink
3 months ago by Aditya Kumar
Excalink is an Obsidian plugin that enables IntelliSense-style autocompletion for groups and named frames inside .excalidraw.md files. When you type [[filename#, it suggests all available frame names, allowing fast, precise linking to parts of your drawings.
Advanced Rename and Delete Handler
3 months ago by Michael Naumov
Handles renames and deletes for the whole vault in one place: updates links, moves attachment files and folders, and cleans up what a deletion leaves behind.
Simple Editorial
3 months ago by Beppe
A minimal editorial markup plugin for writers using Obsidian.
Table Resize
2 months ago by lishuai1993
调整obsidian中表格宽度的插件
Format Convert Copy
2 months ago by shallow1992
Obsidian plugin to convert Markdown text or active notes into Slack, Discord, and WhatsApp formats, or copy as raw Markdown with one tap.
OsyC
2 months ago by 3yesore
Quran Life
2 months ago by Imed Ghomari
Projects Plus
2 months ago by Pavel
Projects Plus turns a folder of notes into a managed project: you see all tasks on a kanban board, all events on a calendar, all cards in a gallery — all without export, without cloud, right in your vault.
Bases Timeline View
2 months ago by xjiaxiang
timeline view for obsidian bases
Prism
a month ago by floorianmb
Prism: sandboxed, themed, interactive visualizations in Obsidian notes
Magical Cards
a month ago by FF Barry
Interactive book and film cover cards for Obsidian, with draggable modules and note embeds.
gogoga Mind Map
a month ago by jackweigogoga
Obsidian plugin: edit Markdown notes as XMind-style mind maps.
Just Simple Planner
19 days ago by David Hurt
A local visual planner for Obsidian: Markdown notes on a continuous timeline, connected threads, compact previews, tasks and notebook view.