User manual

Before you begin

Files access is granted through the system picker. A file provider may need its own account or internet connection. Optional Syncthing connections may require Local Network permission and share data with the peers you configure.

Write your first document

1. On the Treo home screen, tap +.
2. Enter text in the new document.
3. Tap Done.

What to expect. A new Untitled.md document is saved in Treo’s Documents folder and its preview is shown. If that name is already in use, the new file gets a numbered name.

Edit and check your Markdown

1. On the home screen, tap Browse.
2. Choose a Markdown or text document in the Files picker.
3. Tap Edit if the document is not already open for editing.
4. Change the text or Markdown formatting.
5. Use Undo or Redo if you need to adjust an edit.
6. Tap Done.

What to expect. The preview reflects the saved text. If saving fails, the editor remains open and an error is shown. Task checkboxes in a Markdown preview can also update and save the corresponding source item.

Find text, share, or rename a file

1. Open the document you want to use.
2. Tap the magnifying glass to show search.
3. Enter the text to find.
4. Tap Done first if you are editing on a narrow iPhone screen.
5. Open the ellipsis menu, More options.
6. Choose Share File to use the system share sheet, or Copy Text to copy text.
7. To rename the file instead, choose Rename from More options.
8. Enter the new name in File name.
9. Tap Rename.

What to expect. Search finds text in editable documents, and the selected share or rename action uses the current file. The same menu includes Duplicate and Delete; Delete asks for confirmation and removes the file.

Set up your reading view and reopen a missing file

1. Open Settings using the gear button.
2. Choose System, Light, or Dark under Theme.
3. Adjust Preview Font Size.
4. Adjust Editor Font Size.
5. Choose Preview or Edit under Default Open Mode.
6. Tap Done.
7. If a recent file does not open, tap Browse on the home screen.
8. Select the file again in the Files picker.
9. When you need diagnostic information, open Settings.
10. Choose Export Logs.

What to expect. The app uses the selected appearance and opening mode. Files stored by a provider may require that provider’s access or network connection. Clear Recent Files removes the recent list, not the original documents.

Connect to an optional Syncthing peer

1. Have a Syncthing peer you control and its shared-folder IDs ready.
2. Open Settings.
3. Turn on Enable Syncthing.
4. Tap Copy Device ID.
5. Add Treo’s device ID to the trusted devices on the peer.
6. Configure the peer to share the intended folders with Treo.
7. Enter the peer’s hostname or address in Peer Host.
8. Enter the peer’s listening port in Peer Port.
9. Enter the shared-folder IDs in Shared Folder IDs.
10. Set Enable Local Discovery if you want local discovery.
11. Set Enable Global Discovery if you want global discovery.
12. Set Enable Relay if you want relay connections.
13. Tap Connect & Probe.
14. Inspect the connection status.
15. Tap Stop Probe when you want to stop the connection.

What to expect. Connection status shows whether the peer can be reached and shared-folder information exchanged. A folder ID is not a device ID. Local connections may require the iOS Local Network permission. Disabling Syncthing preserves saved connection settings. Actual connectivity depends on the peer and network.

If something goes wrong

A recent file will not open?

Use Browse to locate it again and renew access. Check that its file provider is available.

A change will not save?

Keep the editor open and review the displayed error. Check the file location and provider connection before trying again.

Keeping or sharing a copy?

Use Share File or Duplicate. Clear Recent Files clears the list, not the documents. Settings → Export Logs provides diagnostic information.

Local-network connection denied?

Review Treo’s Local Network permission in the iOS Settings app, then retry Connect & Probe in Treo’s Settings. Confirm the peer is reachable and shares the same folder IDs.