Support
Questions, bugs, or feature requests? Send an email to lucasappsupport@gmail.com, ideally with your macOS version, app version (iDrawArch → About iDrawArch), and a short description.
Storing and syncing
Where are my documents stored?
By default in your private iCloud Drive, alternatively only on this Mac in the app folder, or in a folder of your choice. The assistant asks on first launch; later you change it under Settings → iCloud & Storage, where “Current Location” always shows where the app actually writes. You can open the assistant again at any time via Help → Welcome & Setup…; it only changes the storage location if you deliberately pick a different one there.
My library is suddenly empty. Where are my files?
They are still there. If iCloud is not signed in yet at launch (after a restart or a system update this sometimes takes a moment), the app writes locally in the meantime and tells you. If iCloud signs in within the first minute, it switches back on its own; if documents or notes are already open by then, at the next launch. “Try Again” above the library triggers the switch by hand. If documents are still in another location, the app says so above the library and under Settings → iCloud & Storage in “Other Places with Documents”, with a button that shows them in Finder.
To check in Finder: press ⇧⌘G and paste one of these paths.
~/Library/
~/Library/
How do I sync between Macs?
Enable iCloud mode: documents then live in your iCloud Drive and appear automatically on every Mac signed into the same Apple account. If two Macs changed the same file before iCloud could reconcile it, 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 one lands as a copy in the library. “Decide Later” postpones the choice. Nothing is discarded silently.
What is a conflict copy?
A version iDrawArch keeps instead of overwriting it. It is an ordinary file you can open, compare, and move to the Trash.
- “Name (conflict from device, date)” is created when you choose “Keep Both” in the conflict sheet.
- “Name (foreign change …)” is created when another device or app changes an open document in which you have changed something too. It sits beside the file; for a file outside the library without folder access, in the library. If you haven’t changed anything, the tab simply takes over the new state.
- “Name (Conflict)” is created for a sticky note: if a tab, another app, or iCloud changes its file while the note is open and you have changed something in it, your text wins and the other version stays beside it. A notice names it.
How do I get an earlier version back?
File → Restore Earlier Version… shows the locally backed-up states of the document. Before every overwrite, iDrawArch keeps the previous state, at most every five minutes, and the last ten remain. “Restore as Copy” puts the chosen state as a copy next to the document; the original stays untouched. The first backup appears as soon as the document is saved a second time.
Where are the backups?
Only locally on your Mac, in the app’s container, never in iCloud. Diagram documents are backed up with their images, text files in full; sticky notes also back up their old state before overwriting. To check in Finder: press ⇧⌘G and paste this path.
~/Library/
Why does the older version open my document read-only?
When a document contains something that only exists since 2.0 (such as tables, waypoints, gradients, sketch style, or saved views), iDrawArch 1.5.0 and 1.6.0 open it read-only: you can look, but never overwrite. That way nothing gets lost that the older version does not know. Documents without such elements remain editable there.
If several Macs work on the same library, it is best to update all of them to 2.0. When a Mac with an older version changes a document that another Mac has meanwhile saved with new elements, the version from 2.0 is kept as a copy “Name (foreign change …)” or as a local backup.
Text pages and notes
How do I create a Markdown file?
Via the “+” next to the tabs, File → New Markdown File (⌥⇧⌘N), or the “New Markdown File” card in the library. You get an ordinary .md file in the open folder that opens as a tab right away and that any other app can open. Markdown File from Template starts from a template, New HTML File creates the same as HTML.
How do I bring in an existing Markdown file?
Drag it from Finder into the library: it lands in the open folder and brings its images
along, the “Name-Bilder” folder beside it as well as every other image it links to
relatively. To add a .md, .html, or .txt file as a new
page to a diagram document, use File → Import Text File…; its images become
part of the package.
How do I make the text column wider?
In the view menu at the top right or under Text → Editor Mode → Text Width: narrow, normal, wide, or full width. Or drag an edge of the column; the line appears on hover and snaps near a step. The choice applies to all text pages.
How do I change the text size of a text page?
On a text page and in a note, ⌘+ and ⌘− change the text size, and ⌘0 restores the default (View → Increase Text Size, Decrease Text Size, Default Text Size). On diagram pages the same shortcuts zoom. You set font design, text size, and source size permanently in Settings.
How do I edit a text page directly, without seeing the markup?
With the switch at the top right or Text → Editor Mode → Edit Directly. There you see the finished text: headings large, bold text bold, tables as tables. In a table you type straight into the cell. You tick a task by clicking its checkbox. Via Source you can check what is actually in the file at any time; switching views alone never changes the content.
Does my Markdown file stay unchanged when I save?
Everything you don’t touch, yes. “Edit Directly” writes back only the paragraphs you changed; everything else stays exactly as it was in the file, character for character, including notations from other apps. A changed block keeps its notation where it means the same. HTML inside a Markdown file is kept character for character as well; scripts and styles never run, and nothing is loaded. Asterisks, hashes, or “1.” that you type as text don’t turn into emphasis, headings, or lists by accident.
You edit HTML pages directly too. A block the display cannot represent is protected with a lock: “Edit Source” jumps there, “Edit Anyway” unlocks it. Head, styles, comments, and everything unchanged stay verbatim.
How do I paste a table from a word processor?
Just copy and paste: a table from a word processor or the browser becomes a real table; headings, lists, bold, italic, and links are kept. If the source app only provides plain text, the app cannot make anything else of it; then copying from the original view instead of a preview window helps.
I really do want just the characters.
Paste as Plain Text in the right-click menu. That drops the content into the text without any conversion.
Which writing commands are there?
The Text menu, the Writing box, and right-click all offer the same ones: paragraph style (headings, lists, task list, quote, plus “Convert Paragraph to Code…”), emphasis (bold, italic, underline, strikethrough, highlight, superscript and subscript, code; ⌘B, ⌘I, ⌘U, ⇧⌘X, ⇧⌘H), insert (image, link with ⌘K, table, code block, horizontal rule, formula, callout, footnote, table of contents, HTML, Emoji & Symbols, embed diagram), and line commands: duplicate (⇧⌘D), delete (⌃⌘K), move up or down (⌃⌘↑/⌃⌘↓), and toggle task (⇧⌘T).
In tables, ⇥ and ⇧⇥ jump from cell to cell, and ⇧↩
breaks the line inside a cell; under Text → Insert → Edit Table you
insert, move, and delete rows and columns in Markdown and align columns left, center, or
right. In lists, ⇥ and ⇧⇥
indent and outdent an item with its sub-items. Code blocks appear in syntax colors for more than 30
languages. Emoji shortcodes such as :smile: turn into emoji as you type, and
⌘Z brings the shortcode back.
How do I insert callouts, footnotes, or a table of contents?
All three are under Text → Insert and exist in Markdown only.
- Callout: Note, Tip, Important, Warning, or Caution, in the widely used Markdown format, collapsible if you like (expanded or collapsed). Apps without callouts show a quote.
- Footnote: puts the reference at the insertion point and the footnote at the end. Clicking the reference jumps to the footnote, clicking its number jumps back; in the right-click menu the commands 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: links to all headings; Text → Update Table of Contents brings it up to date. Links to headings jump with a click in the preview and with ⌘-click in “Edit Directly”.
How do I link to another page or note?
With a wiki link: after two square brackets ([[) iDrawArch suggests matching
pages of the document and notes in the library. A wiki link can carry its own text or jump
to a heading. In the preview a click is enough, in “Edit Directly” a ⌘-click; in
a note you link to notes. Set or change other links with ⌘K (address, title,
text); “Remove Link” takes one off again.
How do I find and replace in the text?
On a text page and in a note, ⌘F opens the find bar in the text, and ⌘G and ⇧⌘G jump to the next and previous match. ⇧⌘F (Edit → Find → Find in Document…) searches all pages of the document, ⌥⌘F (Text → Find & Replace in Text…) finds and replaces in the text.
Images on text pages
How do I insert an image?
Via Text → Insert → Image… (several at once, too), by pasting (⌘V), or by dragging it in, in “Edit Directly”, in the source, and in a note; the note menu also offers “Insert Image…”. iDrawArch converts HEIC and TIFF images when storing them, photos to JPEG, screenshots and graphics losslessly to PNG; photos larger than 3000 pixels are scaled down to 3000 pixels. The same image takes up space only once.
Where do images go when I drag them into a note?
In a diagram document they go into the .drawarch package, so they are part
of the file. For a single .md or .html file they go into the
“Name-Bilder” folder beside it, so for “Note.md” into “Note-Bilder” (the suffix stays
“-Bilder” in the English app too). That folder follows along when the file is renamed, moved, or trashed,
and the references stay intact.
How do I change the size of an image?
In “Edit Directly”, in two ways. Clicking the image shows a frame with corner handles: dragging resizes it keeping the aspect ratio, with ⇧ held down in quarters of the text column. Double-clicking opens the image settings: size as original, 25, 50, 75, or 100 % of the text column, or as a fixed width in points. ⌘Z undoes each change in one step. Without the mouse you reach the settings via Text → Edit Image…, and VoiceOver offers the actions “Larger” and “Smaller” on the selected image.
It is saved so that other Markdown apps show size and alignment too; without settings the image stays plain Markdown. iDrawArch reads notations from other apps and leaves them as they are.
How do I wrap text around an image?
In the image settings or via right-click under “Alignment”: 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, outside of lists, quotes, and tables.
How do I give an image a caption?
In the image settings under “Caption”. It appears below the image, in “Edit Directly”, in the preview, in PDF, and in print. The “Description” next to it stays invisible: VoiceOver reads it aloud, and it shows where an image is missing.
More commands are in the right-click menu of an image, in the source too: Edit Image…, Replace Image…, Size, Alignment, Copy Image, Show in Finder or Save Image…, Quick Look, and Remove Image.
Why does the app ask for a folder for files outside the library?
When you open a .md or .html file outside the library, macOS
gives iDrawArch access to that one file only, not to the folder beside it where its images
are or where new ones should go. That’s why iDrawArch asks once for this folder: when
opening, if the file 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 last 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….
How do I tidy up unused images?
For a single .md or .html file,
Text → Move Unused Images to Trash… (also in the page’s “…” menu) moves the
images from its images folder that the text no longer refers to into the Trash. iDrawArch
asks first, with their number and names, and nothing is deleted permanently. In a note the
command is in the note menu. A diagram document doesn’t need it: saving removes images from
the package that no page uses anymore.
Why doesn’t an image from the web appear?
iDrawArch deliberately does not load images with a web address; in their place it says “Images from the web are not loaded.” The app makes no network connections (see Privacy). Download the image and insert it, and it stays with your data.
Sticky notes
How do I move a sticky note?
Drag it by the header or the bare paper; resize it with the grip at the bottom right. Every note remembers its own position and stays on the screen you put it on. It may hang over the edge; it is only pulled back when nothing would be left to grab.
Where are the buttons of my note?
They appear as soon as the pointer is over the note; otherwise there is only paper. With VoiceOver or full keyboard access, they stay visible. At the bottom you choose the view, the eraser clears the note (⌘Z brings the text back), the Format button offers the writing commands, and the note menu next to it everything else.
How do I format text in a note?
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; ⌘A, ⌘C, ⌘X, ⌘V, ⌘Z, and ⇧⌘Z also work in menu bar mode and with the main window closed.
Where are sticky notes stored?
Every note saves itself as a real file in the “Quick Notes” folder of your library, as
.md, or .html for an HTML note. The first line you write becomes
its name, and the file name follows it; a line holding only an image doesn’t count. Before
overwriting, a note backs up its old state locally, like a document. If saving fails, for
example because a drive is gone or iCloud is locked, a copy lands in the app’s container
under “Application Support/iDrawArch/Notizen”, and the app tells you.
How do I print a sticky note?
Choose “Print…” in the note menu, or press ⌘P while the note is in front. It prints typeset like a text page. “Save as PDF…” in the same menu stores it as a PDF. An empty note prints nothing.
How do I stop a note from floating above every window?
Turn off “Always in Front” in the note menu; the same choice is under Settings → General → Keep Notes in Front. Turned off, notes behave like normal windows.
Printing and exporting
Which export formats are supported?
PDF, PNG, JPEG, TIFF, BMP, and vector SVG via File → Export…
(⌥⇧⌘E) or the export button at the top right; text pages show their images at
their set size. The export dialog also offers HTML document, e-book, Word and RTF on text
pages, and XML diagram file, Office drawing, and DXF for other apps. To save a text page on
its own, use File → Quick Export → Text Page as File… for .md
or .html; if it has images or embedded diagrams, you get a folder with the file
and its images folder, with diagrams as PNG. Text Page as Standalone HTML… embeds
all images and diagrams.
How do I print a text page?
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. Callouts, numbered footnotes, colored code, and images print as in the preview. Long code blocks, tables, and paragraphs continue line by line on the next page, the table header repeats on every page, and a heading never stands alone at the bottom of a page.
Are links in a PDF clickable?
Yes, in exported and printed PDFs alike. Table of contents entries, anchor links, and footnote references jump to their place.
How do I copy a page as an image or as Markdown?
Edit → Copy as Image (⌃⌘C) puts PNG and PDF on the clipboard. Individual pages or the current selection can be copied as an image this way; a text page comes in full length on white, and the text stays readable in dark mode. Text → Copy as Markdown copies the selection or, without one, the whole page or note as Markdown source, also from the preview; HTML pages are converted.
Organizing and handling
How do I rename a document?
Four ways: right-click the tab, use the inspector (⌥⌘I), use the context menu in the library, or, for the selection in the library, File → Rename…. The tab also offers “Show in Finder” as well as “Close Other Tabs” and “Close All Tabs”. For a note, renaming also changes its title line; iDrawArch makes a backup first.
How do I rename a page?
Double-click the page in the page pill at the bottom left, or right-click → Rename…. If the document has only one page, a click on its name is enough.
How do I change the order of pages?
File → Move Page Forward (⌥⇧⌘↑) and Move Page Back (⌥⇧⌘↓) move the current page; right-clicking a page in the page pill offers “Move Left” and “Move Right”. File → Duplicate Page puts the copy right after the original.
How do I switch tabs with the keyboard?
⇧⌘] and ⇧⌘[ cycle through the library and your tabs; the Window menu lists all tabs. When not all tabs fit, “+n” collects the rest.
How do I create folders?
⇧⌘N creates a subfolder inside the open folder, up to ten levels deep. 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. Folders are real folders on disk: in Finder the structure looks exactly like it does in the app.
How do I find everything with a tag?
With the tag button at the top: “Filter by Tag” shows everything with that tag from the whole library, and “Show All” clears the filter. As with search, each card then shows its folder; a click on a folder ends filter and search.
Can I use iDrawArch with the keyboard and VoiceOver?
Yes. In the library the arrow keys move the selection, ↩ opens, ⌘↑ goes to the enclosing folder (View → Enclosing Folder), ⌘⌫ moves to the Trash, and ⌘A selects all. In the sidebar ↑ and ↓ change the folder, ← and → collapse and expand it. VoiceOver reads the canvas aloud, connectors as “A → B”, and the shape catalog works with the keyboard and VoiceOver. With VoiceOver or full keyboard access, tool boxes and buttons stay visible.
How do I open iDrawArch at login?
Under Settings → General → Open at Login, also in the assistant on first launch. iDrawArch is then in the macOS login items and 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 opens System Settings on request. You remove the entry with the same switch or under System Settings → General → Login Items & Extensions.
How do I open the first-launch setup again?
Via Help → Welcome & Setup…. The assistant takes you through five short steps: storage location (iCloud Drive, only on this Mac, or a custom folder), features, and options: appearance, “Menu Bar Only”, “Open at Login”, “Keep Notes in Front”, and restoring the last session. It only changes the storage location if you deliberately pick a different one there.
How do I switch between light and dark?
Under View → Appearance: System, Light, or Dark. A checkmark shows the current choice, and open notes follow immediately. Under Settings → Appearance you also pick a theme for text pages and notes, one for light and one for dark.
Diagrams
How do I format just a single word?
Double-click the shape to open text editing. Select the word there with the mouse or ⇧+arrow keys. Everything you set afterwards (bold, size, font, color) applies to exactly that selection. With nothing selected, the setting applies from the cursor onward, so to whatever you type next. The format bar tells you what it currently affects.
My formatting suddenly applies to the whole text.
Then no text editing is active. Outside of editing, the same commands format the entire text of every selected shape; that is intended. Double-click into the shape and the selection applies.
How do I remove formatting again?
Format → Text → Clear Formatting resets the selected sections to the shape’s base style. The inspector offers the same command as soon as a shape contains section-formatted text.
How do I create a custom shape?
Draw an outline with the pen, select the strokes, and click the lasso icon in the format bar (or Format → Freehand → Convert to Custom Shape). Press ⇧⌘B to save the shape permanently as a stencil.
Can I change a custom shape afterwards?
Yes: select the shape and press ⇧⌘E. Then drag the individual points, ⌥-click removes one, double-click on the outline inserts one. ⎋ leaves the mode. Flipping works with ⌃⌘H and ⌃⌘J; change the shape type by right-clicking a shape under “All Shapes…”.
How do I label a connector?
Select the connector and start typing, press ↩, or double-click it; from the menus, use Format → Connector → Edit Label….
Why can’t I select or change some shapes?
If they are on a hidden or locked layer, Select All, deleting, moving, and formatting leave them untouched. You find the layers under View → Layers…. Unlock a single locked object by right-clicking it → “Unlock” or with Format → Unlock, or all at once with “Unlock All Objects” in the page’s right-click menu.
Where did the tools go?
They float above the page as tool boxes and appear when you need them: shapes with the shape tool (S), drawing with the drawing tool (P), writing while you type on a text page. The pin keeps a box in place. If you unpinned a box, bring it back via View → Pin Tool Boxes. The inspector starts closed and opens with ⌥⌘I.
The AI features are missing on my Mac.
“Diagram from Text”, “Change with Apple Intelligence…”, describing a page, and the note commands (Summarize, Suggest Title, Extract Tasks, Tidy Up) require Apple Intelligence on your device. On Macs without Apple Intelligence enabled they are not available; everything else works independently.
Is there a demo?
Yes: Help → “Open Showcase: App Design” creates a multi-page sample document with architecture, user flow, release plan, and notes.
Where can I find the licenses?
Under iDrawArch → About iDrawArch → Licenses. iDrawArch uses only frameworks that come with macOS; it contains no third-party components.
Locking and versions
How do I lock a document?
File → Lock… asks for a password. The document is then stored encrypted on disk, including its images and attachments; only the title and a lock remain readable. The library shows just the title of locked documents, search finds them by title only, and the preview in Finder shows a lock. Unlock and Change Password… are in the same menu.
I forgot the password.
Then the document can no longer be opened. Locked documents are encrypted, and only you know the password: there is no back door and no recovery, not through iDrawArch and not through support either.
One exception: if you turned on “Open with Touch ID on this Mac” for the document, it still opens with Touch ID on this Mac. Copy its contents into a new document then. Touch ID applies per Mac and does not replace the password.
How do I keep a state as a version?
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. Like backups, named versions are stored locally on your Mac.
Privacy and Mac
Does iDrawArch load link previews from the internet?
No. A link card is built only from what the browser hands over when you drag: the address and the title; without a title, the card shows the domain. iDrawArch never fetches a page’s title, preview image, or icon. The app has no permission for network connections; it does not load images with a web address either.
Where are the local caches?
In the app’s container on your Mac, never in iCloud. This path holds the folders “Index” (the library’s search index), “OCR” (text recognized in images), and “Herkunft” (the marking of AI-generated text), next to “Sicherungen” (backups) and “Versionen” (versions):
~/Library/
Settings → General → Clear Local Caches deletes the search index, the image text, and the marking. The search index and the image text are rebuilt when needed, the marking is not; backups and versions stay untouched. Text from images in locked documents is never stored in the first place.
Why does iDrawArch ask for the microphone or for notifications?
For the microphone only when you start a recording with Text → Insert → Audio Recording…. The recording and its transcript are created on your Mac and stay with your document. For notifications only when you set a reminder on a sticky note with “Remind Me…”; it applies on this Mac and never leaves it. You change both in System Settings under Privacy & Security and Notifications.
How does Finder preview my documents?
With the Space bar: all pages of a document as of its last save, up to 30 pages, and Markdown files typeset as in iDrawArch. Locked documents show only a lock. If Finder shows another app’s preview for Markdown files, turn off that app’s extension in System Settings under General → Login Items & Extensions → Quick Look; Settings → General → Preview with Space Bar takes you there.
How do I make iDrawArch the default app for Markdown files?
Settings → General → Markdown Files, “Make Default…”. macOS asks before it changes the default app. iDrawArch changes it only through this button, never on its own.
Good to know
- This page describes iDrawArch 2.0.0. The app requires macOS 26 (Tahoe) and also runs on macOS 27.
- Locked objects can be unlocked via the page’s right-click menu.
- The source of a text page is always authoritative. Anything the direct editing view cannot display is kept in the file and visible there; on HTML pages a lock protects such a block until you unlock it.
- A file from a newer version of iDrawArch opens read-only: you can view it, but it is never overwritten.