Project documents

Create and edit Markdown files, read them alongside a diagram, and share saved Cloud documents, diagrams, and folders.

On this page

Create, edit, and save Markdown

Start a document in Projects

  1. 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.
  2. 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.
  3. 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

  1. 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.
  2. 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.
  3. 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.

Share Cloud diagrams, documents, and folders

In Projects, open the Cloud item or folder’s Actions menu and choose Share. Create a link and send it to recipients with its password. Anyone with both can open the link without an account. To share an item from your account’s Local storage, first use Copy to Cloud and share the independent Cloud copy. Use Manage sharing to change the password or Stop sharing to revoke access.

What recipients can open after entering the password

Shared linkWhat recipients can do
DiagramExplore and export the shared diagram or choose Make it mine to create an editable Local copy.
DocumentRead the shared Markdown file, download its .md source, or choose Make it mine to create a Local copy. The individual link authorizes only that document.
Project folderBrowse saved documents and diagrams in the folder, open a document beside a diagram from the same folder, and export individual items. Folder viewers have per-item export controls.

A folder link shows the saved contents of the folder as they change. Items you add become visible to recipients, items you move out disappear, and deleting the folder ends access through its link.