Notes

An md-doc note is living documentation: it explains how something is done or how it is set up, and it is rewritten to reflect the current state. It is not a diary; that is what logs are for.

What it includes

• Markdown with a visual editor, preview and code blocks.
• Folders to organize them, and tabs to keep several open at once, with a dot on tabs that have unsaved changes.
• Global search and in-note search.
• References between items: type $ in the editor to link to other notes, logs, issues, records and environments. The links feed a connection graph.
• Keyboard shortcuts, including Ctrl/Cmd+S to save and full-screen mode.
• Real-time changes: if an AI, another tab or another person modifies a note you have open, md-doc tells you and, if you have unsaved changes, lets you choose which version to keep.
• Attachments on each note.
• Spanish and English interface, light and dark mode.

How an AI uses them

Through the MCP server the AI can search, list, read, create and update notes and folders. To link items it writes chips in the content, for example $[note:42:Contract]; on save, the graph updates itself.

A well-instructed AI searches first to avoid duplicates, rewrites the note when how something works changes, and records the change in a log.

When to use a note

Use a note if the text will still be true tomorrow: a procedure, an architecture, a decision, a configuration. If it starts with “today I did…”, it belongs in a log. If it is something left to do, it is an issue.