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.
- Tool boxes float above the page and appear when you need them: shapes with the shape tool, drawing with the drawing tool, writing while you type on a text page.
- The pin in a box keeps it in place. Bring unpinned boxes back via View → Pin Tool Boxes; unpinned tools also appear as soon as the pointer reaches the left edge.
- Pages and zoom sit as small pills at the bottom: the current page on the left, zoom on the right.
- With VoiceOver or full keyboard access, tool boxes and buttons stay visible. VoiceOver reads the canvas aloud, connectors for example as “A → B”, and the shape catalog works with the keyboard as well.
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
- Choose the shape tool (S): the Shapes box with the basic shapes appears at the bottom. Click a shape and drag it out on the canvas, or drag it in.
- “All Shapes…” in the same box opens the whole collection of more than 160 shapes; the search field finds every one of them. Insert → Symbol… opens the symbol browser with its own search.
- Labeling: select a shape and just start typing, or double-click to edit the text.
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
- Drawing tool (P): the Draw box appears at the bottom with five brushes (pencil, pen, brush pen, marker, highlighter), color, and stroke width.
- Custom shape: select your strokes → lasso icon in the format bar → the drawing becomes a real, scalable shape.
- Press ⇧⌘B to save any selection as a stencil under “My Stencils”.
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.
- Reattach ends: drag the round handle at the start or end onto another shape. While you drag, the connection points of the target shape appear, and the end snaps to one nearby; with ⌘ it stays movable and finds its point itself. Released over empty canvas, the end becomes a free point. The context menu and Format → Connector offer “Detach Start”, “Detach End”, and “Release Fixed Point”.
- Shape the route: an orthogonal connector carries a small diamond at the middle of each segment; dragging it moves the segment and the line stays right-angled. On straight and curved connectors, dragging a diamond inserts a point, a square moves it, and a double-click on it removes it. By right-click: “Add Waypoint” and “Reset Route”.
- Avoid obstacles: the routing “Orthogonal (Avoid Obstacles)” under Format → Connector → Routing, in the context menu, the inspector, and the format bar leads connectors around other shapes at right angles. If there is no way through, the line runs like “Orthogonal”.
- Labels: a double-click on the line of a labeled connector adds another label there; you can drag it along the line. Right-click → Multiplicity sets 1, 0..1, *, 1..*, or 0..* at the start or end. In the inspector, connectors carry a note, a link, and object data just like shapes.
- Finishing touches under Format → Connector: “Round Corners”, “Crossings” (arc, gap, or none), “Arrowhead Size”, and “Animate Flow”. The “Junction” from the basic shapes is a small dot where connectors meet or branch.
- Quick connect: a selected shape shows arrow buttons on all four sides when you hover over it. A click adds a matching shape in that direction, connects it, and opens its label; from the keyboard with ⌘← ⌘→ ⌘↑ ⌘↓. Arrange → Connect To… (⌥⌘E) connects the selected shape to one you find by name.
11. Tables and Content
The canvas holds more than shapes. The Insert menu brings tables, formulas, code, files, and cards onto it.
- Table: Insert → Table…, then choose the size. A double-click in a cell or ↩ on the selected table starts editing; ⇥ and ⇧⇥ move between cells, ⇥ in the last cell adds a row, ⌥↩ breaks the line inside a cell, ⎋ ends editing. Inserting and deleting rows and columns, the header row, and the key column are in the cell’s right-click menu and under Format → Table. Drag a column edge to change its width.
- From the clipboard: cells copied from a spreadsheet app or text with separators ask “Paste as Table?” when you paste.
- Database entity: “Entity (Table)” from the ER Model palette. Connect foreign keys with the connector tool from row to row; when you insert rows, the connectors move along.
- Formula and code: Insert → Formula… places a formula as its own object, Insert → Code… a code object with syntax colors (⌘↩ inserts it). A double-click edits either one.
- Files: drag them in from Finder, paste them, or use Insert → File…. The file is stored as a copy in the document and shows its preview; a double-click or the Space bar opens Quick Look. A PDF stays sharp as an image when you zoom, and an SVG file becomes a group of editable shapes.
- Link card: drag a link from your browser onto the canvas. iDrawArch loads nothing from the network for it; the title comes from the browser, otherwise the card shows the domain.
- Text page card: Insert → Text Page Card shows the title and the beginning of a text page of the same document; a double-click opens the page.
12. Containers and Layouts
- Containers: a shape whose center lies inside a container when you drop it becomes its member; the container lights up while you drag. Move the container and all members move along. Arrange → Put in Container wraps a container around the selection, Remove from Container takes a shape out.
- In the inspector, section “Container”: with “Grow with Contents” the container grows with its shapes, and “Clip Contents” hides whatever reaches beyond its edge.
- Collapse: Arrange → Collapse/Expand (⌥⌘K) shows only the title bar of a container. Connectors to hidden shapes end at the bar in the meantime.
- Lanes: the pool with lanes comes from the Process Model palette. Shapes belong to the lane their center lies in; in the inspector you name lanes, reorder them, and add or remove them.
- Groups in groups: ⌘G on a selection that contains groups creates an enclosing group. A double-click enters a group, ⎋ leaves it level by level.
- Layouts: Arrange → Arrange Automatically offers Tree, Radial, Force-Directed, and “Tidy Up Grid”. The result first appears as a preview with dashed outlines: “Apply” (↩) carries it out, “Cancel” (⎋) leaves everything as it is. The command acts on the selection from two objects up, otherwise on the whole page; locked objects stay put.
- Mind map: File → New Page ▸ Mind Map or “Live Layout” in the page inspector. ⇥ adds a child, ↩ a sibling, ⌥↩ breaks the line in the text, ⌫ deletes the branch. ⌥⌘K collapses and expands a branch; a node dragged onto another one moves there with its branch.
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 }
- Typing draws after a short pause. New shapes appear next to their neighbors, existing ones stay where they are, including those you moved by hand.
- It works the other way round as well: renaming, deleting, connecting, and coloring on the canvas rewrite only the line concerned. ⌘Z undoes drawing and text together.
- Errors are underlined in red, hints in orange; the list below jumps to the place. A faulty line takes nothing off the canvas until it is valid again.
- Diagram text in the widely used notation for flowcharts and sequence, class, ER, and state diagrams is read by File → Import ▸ Diagram Text…; when you paste such text, iDrawArch asks whether to paste it as a diagram. On text pages, a code block with diagram text appears as a diagram. Edit → Copy as Diagram Text goes the other way.
- From a list: right-click a list on a text page, “As Diagram Page…”, then tree, mind map, or sticky notes.
- In your own words: Edit → Change with Apple Intelligence… takes a description of a change to the page. The suggestion first appears in color on the page, and “Apply” carries it out. The model runs on your Mac.
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.
- Paging: forward with →, ↓, or the Space bar, back with ← or ↑; digits and ↩ jump to a page, ⎋ ends.
- During the presentation: L toggles the laser dot, B shows a black screen, T starts and pauses the timer, ⇧T resets it.
- Steps: in the inspector under “Presentation”, “Appears in Step” decides when a shape is revealed. Arrange → Assign Steps in Selection Order numbers them in one go.
- Speaker notes are written in the page inspector. They appear only in the presenter view, never on the slide or in an export. The presenter view, the screen, the laser color, and the countdown are set under View → Presentation Settings….
- Views: View → Views → Save Current View… remembers a part of the page; with “Views as Slides”, every saved view becomes a slide of its own.
- Handout: File → Export… (⌥⇧⌘E) with the format PDF and the range “Each Step (PDF)” writes one page per build step.
- For showing on your own screen: View → View Only (⇧⌘R) blocks every change, Hide Controls (⌃⌘B) clears the canvas, and the Overview Map (⌃⌘M) shows the whole page in miniature.
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:
- Edit Directly: the finished text instead of its markup. Headings large, bold text bold, tables as tables. In a table you type straight into the cell. Tasks carry a checkbox; click it or press ⇧⌘T to tick it.
- Source: the file exactly as it is on disk. It always stays the truth; switching views never changes the content.
- Split: source on the left, preview on the right.
- Preview: the result only.
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.
- Callouts: Text → Insert → Callout adds a Note, Tip, Important, Warning, or Caution box in the widely used Markdown format. The same menu makes it collapsible: “Not Collapsible”, “Collapsible, Expanded”, or “Collapsible, Collapsed”. Apps without callouts show a quote.
- Footnotes: Insert → Footnote puts the reference at the insertion point and the definition at the end. Clicking the reference jumps to the footnote, clicking its number jumps back; on right-click these are “Jump to Footnote” and “Back to Reference”. Preview and export number the footnotes and collect them at the end of the page.
- Table of contents: Insert → Table of Contents adds a list of links to the headings, Text → Update Table of Contents refreshes it. Links to headings jump there, with a click in the preview and a ⌘-click in “Edit Directly”. HTML export carries the same anchors.
- Wiki links:
[[Page name]]points to a page of the document or a note in the library,[[Page name|Text]]with text of your own,[[Page name#Heading]]straight to a heading. After two square brackets iDrawArch suggests matching names. They open with a click in the preview and a ⌘-click in “Edit Directly”; in a sticky note, wiki links point to notes only. - Emoji: shortcodes such as
:smile:, about 700 of them, turn into emoji as you type, in “Edit Directly” as well as in the source, never inside code; ⌘Z brings the shortcode back. Insert → Emoji & Symbols opens the macOS character viewer. - Tables: Insert → Table… asks for the size, picked in a grid. Insert → Edit Table inserts rows and columns before or after, deletes and moves them, and aligns columns left, center, or right, without you typing any dashes. ⇥ and ⇧⇥ jump from cell to cell, in the source too, ⌃⌘↑ and ⌃⌘↓ move the table row, and ⇧↩ breaks the line inside a cell.
- Code blocks: Insert → Code Block… asks for the language. For more than 30 programming and markup languages, code appears in syntax colors, light and dark, in “Edit Directly”, source, preview, and export. Right-click changes the language under “Code Block Language”, and Text → Paragraph Style → Convert Paragraph to Code… turns a paragraph into code. Inside code the system changes nothing: no autocorrection, no substitution, no spelling underline.
- HTML in Markdown is kept character for character. A safe selection (images, line breaks, underline, highlight, superscript and subscript, keys, small text, collapsible sections) is displayed, everything else as a code box. Scripts and styles never run, and nothing is loaded. Text → Edit HTML… opens such a block, Insert → HTML… adds a new one.
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.
- Size and more: double-click an image or choose Text → Edit Image… to open a popover with size (original, 25, 50, 75, or 100 % of the text column, or a fixed width in points), alignment, description, and caption, plus “Replace…” and “Remove”. ⌘Z takes back “Apply” in a single step.
- Drag handles: clicking an image in “Edit Directly” shows a frame with handles at the corners, on a text page as in a note. Dragging resizes it keeping the aspect ratio, in quarters of the column while you hold ⇧; ⌘Z undoes it in one step. VoiceOver offers the actions “Larger” and “Smaller”.
- Alignment and text wrap: Left, Center, Right, Left with Text Wrap, or Right with Text Wrap. With wrap, the following text runs beside the image, in the preview as well as in PDF, image, SVG, and print when both fit on one page. An image can be aligned when it stands alone in a paragraph.
- Caption: it appears below the image, in “Edit Directly”, preview, PDF, and print. The description stays invisible; it is for VoiceOver and for when an image is missing.
- Right-click an image, in the source too: edit image, replace image, size and alignment as submenus, copy image, show in Finder or save image, Quick Look, and remove image.
- Compatible: images are saved so that other Markdown apps show size and alignment too; without settings it stays plain Markdown. Notations from other apps are read and kept.
- Formats: when stored, HEIC and TIFF images are converted, photos to JPEG, screenshots and graphics losslessly to PNG. Photos larger than 3000 pixels are scaled down to 3000 pixels. A converted photo loses its location and camera data.
- Tidy up: for a single
.mdor.htmlfile and in a note, Text → Move Unused Images to Trash… (also in the page’s “…” menu) moves images the text no longer refers to into the Trash after asking with their number and names, never permanently. - Bring them along: a
.mdor.htmlfile you drag from Finder into the library or bring in with File → Import Text File… takes its images folder and relatively linked images with it. For files outside the library, iDrawArch needs access to the folder once, see Library and Folders.
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.
- Move: drag by the header or the bare paper.
- Resize: drag the grip at the bottom right.
- The buttons at the bottom (eraser, format, view, menu) appear as soon as the pointer is over the note; otherwise there is only paper.
- Every note remembers its own position and stays on the screen you put it on, even with several displays connected. It may hang over the edge; it is only pulled back when nothing would be left to grab.
- The writing commands from the Text menu work in a note too, as soon as it is in front.
- Format: the Format button and right-click offer the same commands as a text page: paragraph style, emphasis, the same insert list (with Callout, Emoji & Symbols, and Edit Table), Update Table of Contents, and Line; with an image selected, its commands come first. ⌘B, ⌘I, ⌘U, ⇧⌘H, and ⌘K format as on a text page.
- Shortcuts: ⌘A, ⌘C, ⌘X, ⌘V, ⌘Z, and ⇧⌘Z work reliably in a note, also in menu bar mode and with the main window closed. ⌘F finds in the text, ⌘+ and ⌘− change the text size. With text selected, the footer shows, for example, “12 of 340 words”.
- Images go in as on a text page, drag handles included; “Insert Image…” in the note menu adds a picture from a file, and “Move Unused Images to Trash…” tidies up the images folder.
- Print: in the note menu, “Print…” prints the note, typeset like a text page, and “Save as PDF…” saves it as PDF. ⌘P prints the note in front; an empty note prints nothing.
- Pass it on: “Add as Text Page to Document” in the note menu adds the note with its format and images to the open document. “Copy as Markdown” puts the selection, or without one the whole note, on the clipboard as Markdown source.
- Always in Front: in the note menu or under Settings → General → Keep Notes in Front. Turned off, notes behave like normal windows.
- Changes from elsewhere: a note opens with the current state of its file and takes over changes from a tab, another app, or iCloud as long as you haven’t changed anything. Otherwise your text wins, and the other version stays beside it as “Name (Conflict)”, with a notice naming it. Before overwriting, a note backs up locally.
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.
- ⇧⌘N creates a subfolder, up to ten levels deep. Renaming and moving to the Trash are in the context menu; Rename… and Show in Finder are also in the File menu. Before a folder goes to the Trash, its open documents and notes are saved.
- Move things by dragging: onto a folder in the tree on the left, onto a folder card, or onto a step of the path above the title.
- Colored tags on folders and documents, assigned and filtered with the tag button at the top. Layout (Large Preview, Compact Grid, Name List) and sorting are in the menu next to it, the search field at the top right (⌘F). “Filter by Tag” and search cover the whole library; each card then shows its folder, and clicking a folder ends filter and search.
- Keyboard and VoiceOver: arrow keys move the selection, ↩ opens, ⌘⌫ moves to the Trash, ⌘A selects all. In the sidebar ↑ and ↓ change the folder, ← and → collapse and expand; ⌘↑ (View → Enclosing Folder) goes up one level.
.drawarch,.md, and.htmlfiles dragged in from Finder land in the open folder; text files bring their images along.- Folders are folders on disk: in Finder and in iCloud the structure looks exactly like it does in the app.
- Right-click a tab: rename, show in Finder, close other or all tabs. When not all tabs fit, “+n” collects the rest.
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
- Lock: File → Lock… protects a document with a password. It is then stored encrypted on disk, including its images and attachments; only the title and a lock remain readable. Unlock and Change Password… are in the same menu.
- Without the password there is no way back. A forgotten password cannot be recovered, not even by iDrawArch. Touch ID applies per Mac and does not replace the password. After five failed attempts the app waits thirty seconds.
- The library shows only the title and a lock for locked documents, search finds them by title only, and the preview in Finder shows a lock. Older versions of the app report a locked document as “from a newer version”.
- Named versions: File → Save Version… (⌥⌘S) keeps the current state under a name. File → Compare Versions… puts two states side by side, Restore Earlier Version… brings one back as a copy. Versions are stored locally on your Mac.
- Variants: “Create Variant” in the page menu creates a page that knows its original; the inspector lists the differences.
- Copies: File → Duplicate (⇧⌘S) opens a copy in a new tab, Save As… (⌥⇧⌘S) saves to another location and continues there.
- Older app versions: iDrawArch 1.5.0 and 1.6.0 open a document with elements from 2.0 read-only. Documents without such elements remain editable there.
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.
- Images and PDF: PDF, PNG, JPEG, TIFF, BMP, and vector SVG. With “Embed diagram data (editable)”, a PNG, PDF, or SVG can later be pasted back as a diagram; the file then contains everything, including notes and object data.
- Documents: “HTML Document” (one file, readable offline) and “E-Book”; on text pages also “Word Document” and RTF.
- For other apps: “XML Diagram File”, “Office Drawing”, “CAD Exchange (DXF)”, and diagram text.
- Layers: printable layers, all visible layers, or one file per layer.
- File → Quick Export exports without the dialog, using the settings of the last export; “Element List as CSV…” is there, too.
- From the library: right-click documents or folders, “Export…”: one PDF per document, a combined PDF, a Markdown folder, or the original files.
- Dragging: ⌥⌘-drag on an object drags the selection as an image into another app or as a PNG into Finder.
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
- Preview in Finder: the Space bar shows all pages of a document as of its last save, and Markdown files typeset as in iDrawArch, with tables, callouts, code, and formulas. Thumbnails show the first page. You turn the two extensions on and off in System Settings under General → Login Items & Extensions → Quick Look; Settings → General → Preview with Space Bar takes you there.
- Default app for Markdown: Settings → General → Markdown Files, “Make Default…”. macOS asks for confirmation; iDrawArch changes the default app only through this button.
- Shortcuts: the Shortcuts app offers four actions: “New Note”, “Append to Note”, “Open Document”, and “Open Today’s Note”. They also work with the main window closed.
- Links:
idrawarch://open,idrawarch://new-note, andidrawarch://today, for example for Shortcuts and Terminal. Links open and create; they never delete or overwrite anything. - Quick capture: under Settings → General → Quick Capture you set a system-wide shortcut that opens a new note or today’s note, even when another app is in front. “Today’s Note” (⌃⇧⌘N) creates exactly one note per day.
- Toolbar: View → Customize Toolbar…. Diagram pages and text pages each have their own toolbar.
Key Shortcuts
| Action | Shortcut |
|---|---|
| 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, Draw | V 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 tool | L E Q |
| Temporary pan | hold 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.