How-To

From empty canvas to finished diagram in five minutes, and on to the documentation that lives in the same file.

1. The Interface

The page comes first. At the top there are only the tabs and a few commands: search, export, “…” for the less common things, and the inspector (⌥⌘I). The “+” next to the tabs creates a diagram, a note, or a folder.

2. Create a Document

⌘N opens the template picker, from class diagram, flowchart, and system architecture to mind map. “Blank Diagram” starts with a free canvas.

On first launch an assistant walks you through setup in five short steps: welcome, storage location (iCloud Drive, only on this Mac, or a custom folder), features, options, and done. The options cover appearance, “Menu Bar Only”, “Open at Login”, “Keep Notes in Front”, and restoring the last session. Help → Welcome & Setup… brings it back at any time; it changes the storage location only when you deliberately pick a different one. You can also switch the appearance (System, Light, Dark) under View → Appearance.

Open at Login (also under Settings → General) adds iDrawArch to the macOS login items, so the app is there right after you log in, handy with notes from the menu bar. If macOS is still waiting for your approval, the app tells you and offers an “Open System Settings” button.

3. Add Shapes

4. Connect

Choose the connector tool (C) and drag from one shape to another; anchors snap automatically. Set routing (straight, orthogonal, curved), arrowheads, and line style in the format bar or inspector. Double-click a connector to label it.

5. Draw Freehand

6. Format

The floating format bar at the top shows exactly the options for the selected type: fill and fill pattern, line style, shadow, typography (all installed fonts, ⌘B/⌘I), arrowheads, and widths. The inspector on the right (⌥⌘I) offers full detail; the right-click menu offers quick actions.

7. Edit Text Inside Shapes

Double-click a shape to open text editing right on the canvas, or select the shape and simply start typing, which replaces the label. Inside the text you select as usual with the mouse or ⇧+arrow keys; ⌘A selects the whole text.

Everything you format then applies only to the selection. One word bold, one line larger, one term in a different color; the rest stays as it is. With nothing selected, the setting applies from the cursor onward, so to whatever you type next.

Font and size show the result immediately as you hover the list; close the list without clicking and everything is back as before. While typing, ⌘X/⌘C/⌘V act on the text and ⌘Z undoes the last keystroke. The system font panel (⌘T) and the character viewer work right inside the field. ⎋ or ⌘↩ finishes editing.

Outside of text editing, the same commands format the entire text of every selected shape. Format → Text → Clear Formatting resets sections to the base style.

8. Rework Shapes

Flip with ⌃⌘H (horizontally) and ⌃⌘J (vertically). With several shapes they also swap places, so the arrangement stays coherent. Change the shape type by right-clicking a shape under “All Shapes…” → “Change Selection to This Shape”: text, colors and connectors are kept.

Once you have turned a freehand outline into a custom shape, you can correct it afterwards with ⇧⌘E: drag points, ⌥-click removes one, double-click on the outline inserts one. ⎋ leaves the mode.

Show rulers with ⌥⌘R; drag guides out of them and objects will snap. ⇧⌘K checks the diagram for loose connector ends, unconnected and unlabeled shapes, and heavy overlaps.

9. Use Pages

The page pill at the bottom left manages the pages: one click shows them all, the plus adds new ones: blank (⌥⌘N), from templates (Notes Page, Release Management), or as a text page in Markdown or HTML (File → New Page). Double-click or right-click a page to rename it. File → Move Page Forward and Move Page Back (⌥⇧⌘↑ / ⌥⇧⌘↓) change the order; File → Duplicate Page puts the duplicate right after the original. Link shapes to pages via the inspector (drill down with ⌘-click).

10. Connectors in Depth

A selected connector shows its handles. They let you route the line exactly the way you need it.

11. Tables and Content

The canvas holds more than shapes. The Insert menu brings tables, formulas, code, files, and cards onto it.

12. Containers and Layouts

13. Diagram from Text

File → New Page ▸ Diagram from Text creates a page with an example: the source on the left, the canvas on the right. View → Diagram Source (⌥⌘U) shows and hides the column.

direction: right
Web: Rectangle "Web App"
Web -> API: requests
API -> DB: reads
group Backend "Backend" { API DB }

14. Presenting

View → Start Presentation (⌥⌘P) shows the document in full screen from the page in front, Present from Beginning (⌥⇧⌘P) from the first one. The document stays unchanged while you present.

15. Write Text Pages

A text page sits alongside diagrams as an equal; the page pill switches back and forth. The text sits in a calm column in the middle. With the switch at the top right or Text → Editor Mode you choose how you see it:

In the same menu, Text Width sets how wide the column is. In “Edit Directly”, ⇥ and ⇧⇥ indent and outdent a list item together with its sub-items, ⇧↩ breaks the line without starting a new paragraph, and ↩ on an empty last line leaves a list, quote, or callout.

The Writing box, the Text menu and right-click all offer the same things: Paragraph Style (headings, lists, task list, quote), Emphasis (bold, italic, underline, strikethrough, highlighted, superscript and subscript, code) and Insert (code block, table, horizontal rule, link, image, footnote, formula, table of contents, HTML, callout, emoji & symbols). ⌘K sets or changes a link with address, title, and text; “Remove Link” takes it off again. Open the outline with the sidebar button at the top left; it jumps to any heading.

Find: on text pages ⌘F opens the find bar in the text, ⌘G and ⇧⌘G jump to the next and previous match, and ⌥⌘F finds and replaces in the text. Searching all pages of the document is ⇧⌘F.

Text size and words: on text pages ⌘+ and ⌘− change the text size, and ⌘0 restores the default. The inspector counts the words of the visible text, without markup; with a selection it shows, for example, “12 of 340 words”.

Nothing gets lost: “Edit Directly” writes back only the paragraphs you change; everything else stays exactly as it was in the file, character for character, including notations from other apps. Asterisks, hashes, or “1.” in your text don’t turn into emphasis, headings, or lists by accident. HTML pages can be edited directly too: only a block the display cannot represent is protected with a lock. “Edit Source” jumps there, “Edit Anyway” unlocks it; the head, styles, comments, and anything unchanged stay verbatim.

Formulas use the usual math notation with dollar signs: $x^2$ stays inline, $$ … $$ on lines of their own is set apart. In direct editing the formula appears typeset in the text, and a double-click opens its source with a preview. Insert → Formula adds a new one. In PDF, image, and SVG export, display formulas are fully typeset and inline formulas appear in linear form (x², √x); the HTML page contains MathML.

Modal Keyboard Editing: once it is turned on under Settings → Writing, keys are commands first: h j k l move, dd deletes a line, yy copies it. i switches to typing, ⎋ back. The full key reference is in Settings.

Pasting that understands the content: copy a table, a list, or formatted text from a word processor or the browser and real Markdown comes out: headings, lists, bold, italic and links are kept, the formatting ballast of the source app is dropped. On an HTML page you get clean HTML instead. If you really only want the characters, use Paste as Plain Text from the right-click menu. The Edit menu also offers “Paste and Match Style” (⌥⇧⌘V), Spelling and Grammar, Transformations, and Speech.

Copy as Markdown: Text → Copy as Markdown, also on right-click, puts the selection, or without one the whole page, on the clipboard as Markdown source, from the preview as well. An HTML page is converted on the way.

Text → Insert → Embed Diagram pulls a diagram page from the same file into the text, visible in preview, PDF, PNG, SVG, and HTML. Text → Apple Intelligence summarizes, suggests a title, pulls out tasks, or tidies up; all of it runs on device.

16. Callouts, Tables & Code

Callouts, footnotes, the table of contents, and editing tables are available in Markdown only.

17. Images on Text Pages

Insert images via Text → Insert → Image…, several at once if you like, with ⌘V, or by dragging them in, in “Edit Directly”, in the source, and in a note. In a diagram document they live in the package; for a single .md or .html file they go into the “Name-Bilder” folder beside it, which follows along when the file is renamed, moved, or trashed. The same image takes up space only once.

18. Sticky Notes

⌃⌘N or “New Note” in the menu of the pencil icon in the menu bar creates a note. It floats above every window, the first line you write becomes its name, and it saves itself as a real file into the “Quick Notes” folder of your library, as .md or, for HTML notes, as .html.

19. Library and Folders

The library is a real folder tree: the structure on the left, the contents of the open folder on the right. Diagrams and notes live side by side in the same folder.

Files outside the library: for a .md or .html file outside the library, iDrawArch asks once for its folder, when opening it if it refers to images beside it, otherwise with the first image you insert. After that its images appear and new ones are stored beside it, even after a restart and when restoring the session. Without access nothing is inserted; a notice offers “Grant Access to Folder…”. You can grant it later with File → Grant Access to File’s Folder….

Backups and earlier versions: before every overwrite, iDrawArch keeps the previous state locally, images included, at most every five minutes, the last ten states per file. Backups stay on the Mac, never in iCloud; notes back up before overwriting too. File → Restore Earlier Version… lists the states, and “Restore as Copy” puts a copy next to the document. The original stays.

Conflicts and changes from elsewhere: if two devices changed the same file, an orange iCloud icon marks the conflict. Clicking it or opening the file shows both versions side by side with preview, date, and device: “Keep This One”, “Take This One”, or “Keep Both”, in which case the other lands as a copy in the library. “Decide Later” puts the choice off; nothing is discarded silently. If another device or app changes an open document, the tab takes over the new state as long as you haven’t changed anything; otherwise the other version is kept as a copy “Name (foreign change …)” beside the file. If a file is renamed or deleted outside the app, the tab follows it or recreates it on the next save. A file from a newer app version opens read-only.

20. Locking and Versions

21. Import and Export

Import: File → Import reads table data (CSV, JSON), a database schema (SQL), diagram text, XML diagram files, Office drawings, Swift source code from a folder, and Word and RTF files. Every import creates new pages, one ⌘Z takes it back, and the message afterwards says what was simplified or left out. Photos and scans come in through File → Import from iPhone or iPad.

Export: File → Export… (⌥⇧⌘E) or the export button at the top right opens the export dialog: format, range (selection, current page, all pages, or pages from and to), background, resolution, and margin. The thumbnail shows the result.

22. Print, Copy & Share

Under File → Quick Export you also save a text page with Text Page as File… as .md or .html along with their images folder (embedded diagrams as PNG), or with Text Page as Standalone HTML…, which embeds everything. In PDF, PNG, SVG, and print, the images of a text page appear at their set size. File → Share… hands the document as a file to Mail, Messages, or AirDrop. Export stencils as .drawstencil files for others.

Print: File → Print… (⌘P) prints all pages of the document, File → Print Text Page…, also in the page’s “…” menu, only the text page in front. With a note in front, ⌘P prints the note.

In PDF, exported or printed, links are clickable; the table of contents, anchor links, and footnote references jump to their place. Long code blocks, tables, and paragraphs continue line by line, the table header repeats on every page, and a heading never stands alone at the bottom of a page. Callouts, numbered footnotes, and colored code appear in PDF, image, SVG, and print as in the preview.

Copy as Image: Edit → Copy as Image (⌃⌘C) puts PNG and PDF on the clipboard. A text page comes in full length on white, and the text stays readable in dark mode.

23. Mac Integration

Key Shortcuts

ActionShortcut
New diagram / New note / New folder⌘N / ⌃⌘N / ⇧⌘N
New Markdown file⌥⇧⌘N
New blank page⌥⌘N
Move page forward / back⌥⇧⌘↑ / ⌥⇧⌘↓
Next / previous tab⇧⌘] / ⇧⌘[
Tools: Select, Hand, Shape, Connector, Text, DrawV H S C T P
Zoom / Fit / Zoom to selection⌘+ ⌘− / ⇧⌘0 / ⌘2
Text size on text pages and in notes / default⌘+ ⌘− / ⌘0
Bold / Italic / Underline / Strikethrough⌘B ⌘I ⌘U ⇧⌘X
Highlighted / Set or change link⇧⌘H / ⌘K
Larger / smaller text⌥⌘+ / ⌥⌘−
Finish text editing⎋ or ⌘↩
Indent / outdent, next / previous cell⇥ / ⇧⇥
Line break without a new paragraph⇧↩
Duplicate / delete line⇧⌘D / ⌃⌘K
Move line up / down⌃⌘↑ / ⌃⌘↓
Toggle task⇧⌘T
Find (in the text on text pages and in notes)⌘F
Find next / previous (on text pages and in notes)⌘G / ⇧⌘G
Find & replace in text⌥⌘F
Find in document⇧⌘F
Paste and match style⌥⇧⌘V
Copy as image⌃⌘C
Print (in a note, the note)⌘P
Flip horizontally / vertically⌃⌘H / ⌃⌘J
Edit points⇧⌘E
Rulers / Check diagram⌥⌘R / ⇧⌘K
Copy / paste style⌥⌘C / ⌥⌘V
Save as stencil⇧⌘B
Show/hide inspector⌥⌘I
Library: enclosing folder / move to Trash⌘↑ / ⌘⌫
Start presentation / from the beginning⌥⌘P / ⌥⇧⌘P
Overview map / view only / hide controls⌃⌘M / ⇧⌘R / ⌃⌘B
Back / forward through followed links⌥⌘← / ⌥⌘→
Add a connected shape⌘← ⌘→ ⌘↑ ⌘↓
Connect To… / collapse and expand⌥⌘E / ⌥⌘K
Object table / diagram source⌃⌘T / ⌥⌘U
Add comment⇧⌘M
Export… / Duplicate / Save As…⌥⇧⌘E / ⇧⌘S / ⌥⇧⌘S
Save Version…⌥⌘S
Focus mode / today’s note⇧⌘J / ⌃⇧⌘N
Lasso, eraser, lock toolL E Q
Temporary panhold Space

Find the full manual inside the app under Help → iDrawArch Help; ⌘? opens the Help menu with its search. The showcase demo document and Welcome & Setup… are there too.