Markdown and Obsidian
Give your AI agent your notes folder or Obsidian vault: it searches them on your computer, next to your chats, mail and meetings.
Your notes already hold your plans, meeting records and decisions. Add your notes folder or Obsidian vault to Memo, and your AI agent can search them on your computer, next to your chats, mail and meetings. Memo reads the files and never changes them.
An agent with access to your notes finds the note where a decision was written down, quotes the line, and shows the notes that link to it. It can also write a new note about a person or a project for you, and save your notes as Markdown files again.
There is no separate Markdown tool: memo reads folders of notes. You need memo installed
(installation). It needs no account and no sign-in: your notes are already on your computer.
On this page:
- Short version
- Markdown folder or Obsidian vault
- What your agent tells you
- Files Memo can read
- Keep your notes up to date
- Write notes and save them as files
- If a note is missing
Short version
The examples use the folder ~/Notes, a notes folder in your home folder. Use the path of yours.
memo folders add ~/Notes
memo sync --only notes --no-embed
memo search notes 'budget'The first command adds the folder and prints its ID, for example 1. The sync reads every file in the folder and in
the folders inside it, and reports how many notes it found. The search shows each matching file and its first
matching line.
--no-embed skips the preparation for search by meaning, so you can start without the search model. Leave it out
once you have the model, and the agent also finds a note by what it means.
Or ask your agent:
Use memo CLI to add my notes folder at ~/Notes and import it.
Tell me how many notes it found and which files it could not read.Markdown folder or Obsidian vault
Memo reads any folder of Markdown files. An Obsidian vault is a folder of Markdown notes that Obsidian opens as one
workspace. Memo finds out which one you have: a folder with Obsidian's own .obsidian folder in it, or in a folder
above it, is read as a vault. You do not need Obsidian to use Memo, and Obsidian does not need to be open.
The two differ in how links and tags are written:
| Requirement | Markdown folder | Obsidian vault |
|---|---|---|
| Links to other notes | [label](other-note.md) | [[Other note]] and [[Other note|label]] |
| Tags | the tags: field at the top of the file | the tags: field and #tags in the text |
| Other names for a note | the aliases: field |
To choose the format yourself, add --format markdown or --format obsidian to memo folders add. Memo skips
hidden folders such as .obsidian.
What your agent tells you
Ask in your own words:
Use memo CLI. Find the note where we decided the Harbour budget. Quote the line with the file name,
and list the notes that link to it.To find a note together with your messages, mail and meetings, the agent runs search all:
memo search all 'Harbour budget'
memo notes show document:3notes show opens one note with its tags, the notes it links to and the notes that link to it. A note from a file
has a reference such as document:3. Copy it from a search result.
A useful answer names the file and quotes the line. An empty answer does not prove that the note does not exist: see If a note is missing.
Files Memo can read
A folder can hold more than Markdown. Memo reads these files too:
| Files | Extensions | What Memo keeps |
|---|---|---|
| Text and Markdown | .txt, .md, .markdown | The text, links and tags |
| Tables | .csv, .tsv, .xlsx, .ods | Cell values, with the sheet, row and column |
| Documents, slides and e-books | .odt, .pptx, .epub | The text, without the layout |
| PDF and Word | .pdf, .docx, .doc | The text, with PDF page numbers |
| Web pages saved as files | .html, .htm | The page's main text and title |
Memo cannot read scanned PDFs (pictures of pages, with no text in them), old .xls files and files larger than
50 MiB. It keeps up to 200,000 characters of each file.
Keep your notes up to date
Run the sync again after you add or edit files. Only the changes are read:
memo sync --only notesTo sync on a timer, for example every ten minutes:
memo jobs start --every 10mYou can add more than one folder. memo folders list shows them all. A folder inside or around one Memo already
reads is refused, because each shared file would then be two notes.
To keep some files out, list them under notes.ignore in the config file. A rule
is a path inside the folder, a folder or a pattern:
{ "notes": { "ignore": ["Journal/Private.md", "Archive", "**/Private*"] } }Write notes and save them as files
Your agent can also write a note in Memo about a person, a message, a project or another note. Writing it sends nothing to anyone.
memo notes add 'Prefers morning meetings' --subject telegram:'Kai Sample'To keep these notes in your vault too, export them as Markdown files:
memo notes export --output-dir ~/Notes/memo --format obsidianUse --format markdown for plain Markdown. Each file gets a memo-id and a memo-hash at the top, so importing
that folder does not create the same note twice. If you edited an exported file yourself, Memo does not overwrite it
and tells you.
A note from your own files is edited in the file, not in Memo. Edit it as usual and run the sync again.
If a note is missing
-
The file is new or changed. Run
memo sync --only notesagain. -
The file was not read. The sync report lists every file it could not read, and why, on every run until the file changes:
notes /home/you/Notes: 41 notes, 2 changed, 0 moved, 0 gone, 1 not read not read: Archive/2009 budget.xls — this file type cannot be read -
A link or a tag is not found. The folder may be read in the other format. Find its ID with
memo folders list, then set the format:memo folders update 1 ~/Notes --format obsidian. The next sync reads every note of that folder again. -
A search by meaning finds nothing. The search model is not downloaded, or the sync ran with
--no-embed. Search by words, or download the model as the installation says.
More about notes, folders and links to people is in Notes and folders. Next: label your notes with tags, or search them.