Help topics
Telescopo uses Markdown files in locations you choose. Start by identifying the file, its folder and the provider responsible for that folder.
Check where the file lives
A note’s location determines where its file lives and how it syncs. A local file stays on that device. For another device to see it, use iCloud Drive or a connected provider available on both devices. Sync Preferences shares supported settings; it does not transfer documents.
| Location | What to expect |
|---|---|
| On This Mac / local storage | Available on this device. Moving between devices requires moving or copying the file. |
| iCloud Drive | Apple’s file sync transfers the document between devices using the same iCloud account. Downloads and uploads can take time. |
| Connected folder or provider | Access and availability depend on that provider and the permission granted to Telescopo. |
| HTTPS Markdown URL | A cached, read-only remote document. Reload explicitly to fetch changes; save a copy to edit. |
Connect a folder without importing a second copy
- On Mac, choose Connect Folder… in Library. On iPhone and iPad, use Library Tools → Connect Folder….
- Select the existing folder in the system picker and grant access.
- Open a known Markdown file and confirm the displayed location. Edits apply to the original file.
- Connect the equivalent folder on another device if you want access there. Connecting a folder alone does not upload it.
Sync settings separately
Open Settings → Files & Sync → iCloud → Sync Preferences to share supported preferences such as appearance and reading settings. This control does not copy a note, relocate a folder or make a local file appear on another device. Turn to the file’s location when diagnosing document sync.
Prepare to work offline
Download the files and attachments in Finder or Files while connected. Open a representative note in Telescopo and check that its images and linked material are available. A placeholder in a cloud folder is not a downloaded document. Work made offline will need time to upload when connectivity returns.
Handle changes from another device
Avoid editing the same file simultaneously while its provider is catching up. If Telescopo reports an external change, read the offered versions before choosing Keep Mine, Keep Other or Keep Both. Preserve both versions when you are unsure, then reconcile the text deliberately. Reloading without reviewing unsaved work can discard an edit.
Recover a prior version or deleted file
For earlier content, open Document Actions → Local History and inspect the available versions. For a deleted note, open Locations → Recently Deleted, preview the item and choose Restore Copy. Local recovery is not a replacement for an independent backup of your documents.
If a note is missing on the other device
- Check the exact folder in Finder or Files on both devices. Verify the same iCloud account or provider is in use.
- Wait for the provider’s upload and download to finish; open the file directly in Files or Finder.
- Reconnect a folder if Telescopo says permission is unavailable. Do not delete the original folder.
- Check the selected Library location and clear filters. Use Search All Files.
- If the problem remains, send support the device, app version, provider and steps. Avoid including private file contents unless needed and safe.
Still need help? Contact support with your device, app version and the steps that led to the problem.
The app’s Help & Shortcuts includes guidance for the device you are using.