Skip to main content
Start with ERD
Products -> ERDPricingDocsBlogSign in한국어Start with ERD

Markdown Documents

Markdown documents are project documents for specs, design notes, runbooks, meeting notes, and any text that should live beside your ERDs, diagrams, and testcases.

Create a Markdown document​

You can create a Markdown document from the same document flow used for other Ainecto tools.

  1. Open File > New Document or click the project/folder new-document action.
  2. Choose the target project and, if needed, a folder.
  3. Select Markdown as the document type.
  4. Enter a title and create the document.

The document opens in a tab. If you create it inside a folder, it appears under that folder in the project tree.

Read and edit​

Markdown documents open in read mode. The viewer renders headings, lists, tables, links, code blocks, and other Markdown content.

Use the right rail for document tools:

PanelPurpose
TOCJump between headings in the current document
VersionsReview saved versions and restore an earlier version
ShareManage document sharing and public links
MetaCheck document metadata
StyleAdjust the reading view

To edit the document:

  1. Click the edit action in the document body, or press Ctrl+E / Cmd+E.
  2. Edit the title or body in the Markdown editor.
  3. Click Save or press Ctrl+S / Cmd+S.

Changes are saved when you run Save. Until then, the tab is marked as having unsaved changes and Ainecto asks before discarding them.

Versions and restore​

Open the Versions panel in the right rail to see recent versions. Click View All for the full version list and compare flow.

Markdown versions are created from saved document states. Each version records:

  • Version number
  • Timestamp
  • Creator
  • Change summary or title
  • The Markdown snapshot for that version

To restore a version:

  1. Open Versions in the right rail.
  2. Click Restore on the target version.
  3. Confirm the restore.

Restore writes the selected version's title and Markdown body back into the live document. The restore itself creates a new version, so the state before restore remains in history.

Version history retention follows your plan limits. Older versions can be locked or unavailable after the plan limit is reached.

Edit with AI Chat​

When a Markdown document is the active tab, AI Chat can read the current document content and selected text. Ask it to rewrite, expand, summarize, polish, or replace the document.

For document edits, AI Chat prepares a full-document replacement:

  1. You send the request while the Markdown document is active.
  2. The assistant drafts the next title and Markdown body.
  3. A preview dialog shows the current version and the proposed next version.
  4. Confirm to save, or cancel to leave the document unchanged.

If the document changed after your prompt was sent, Ainecto opens a conflict dialog instead of overwriting silently. The dialog shows your attempted content, the latest server content, and an editable merge area. Choose one side or edit the merge, then save the merge.

Shared read-only documents cannot be edited by AI Chat.

Search Markdown documents​

Use global document search when you need to find a Markdown document by title or body text.

  1. Open File > Search... from the top navigation, or press Ctrl+Shift+F / Cmd+Shift+F.
  2. Choose Current project or All workspace.
  3. Optionally filter the type to Markdown.
  4. Type a query and select a result to open it.

Search results can include document titles and content previews. The global search is workspace-scoped; it is separate from canvas search inside an ERD or diagram.

MCP and CLI access​

Markdown documents use the public document type markdown.

For MCP:

  • Create a document with mcp__ainecto__create_documents and type: "markdown".
  • Replace the title or body with mcp__ainecto__update_documents.
  • Append content with mcp__ainecto__markdown_append_document.
  • Ask Ainecto to generate content with mcp__ainecto__markdown_generate_document.
  • Search with mcp__ainecto__search_documents, optionally filtering type: "markdown".

For large document bodies, request an upload token with purpose=document.create, document.update, or document.append and upload the body directly instead of passing it through a chat prompt.

See MCP Tool Reference for exact schemas and examples.