Project documents
Create and edit Markdown files, read them alongside a diagram, and share saved Cloud documents, diagrams, and folders.
Create, edit, and save Markdown
Start a document in Projects
- Open Projects and select a folder or Unfiled. Use New document to start a blank file, or Import .md to bring in an existing UTF-8 Markdown file up to 2 MiB. The document appears in the Documents group. Sign in to use Cloud storage.
- Choose Edit to write Markdown and Preview to read the current draft. Choose Save or press Ctrl/Cmd+S to keep your changes. If you switch to another item with unsaved changes, the designer asks how to proceed.
- Choose More → Download .md to keep a copy of the current Markdown source, including unsaved edits. Use the document row’s Actions menu in Projects to rename, move, copy, or delete the saved document.
Link to other Markdown files in the same folder by filename, with an optional heading fragment, such as [Decisions](notes.md#decisions). After a rename or move, update any affected links yourself. For images, use HTTPS URLs the reader can access.
Read a document alongside a diagram
Open a companion diagram
- Choose Document + diagram (With diagram on smaller screens) and select a saved C4, System Design, or Sequence diagram from the same folder and storage location.
- Use More → Set as default, then Save, to remember the companion. The document pane shows your current draft. The diagram pane presents the saved diagram for read-only navigation and export.
- Drag the divider on desktop to resize the panes. On a phone, switch between the Document and Diagram tabs.
In Preview and shared readers, use the − and + buttons to adjust the document text size. Use Document outline to show or hide On this page, then select a heading to jump to it. On a narrow screen, open On this page first. Choose Full width in standalone Preview to widen the document.