From ce524225a4c74aed82813b9bc067fd54c8160516 Mon Sep 17 00:00:00 2001 From: Christopher Warner Date: Sat, 10 Oct 2026 18:56:14 -0400 Subject: feat: format notes with Apple Notes-style structure Rewrite Markdown bodies into title, headings, spaced paragraphs, and Notes-friendly lists so iPhone notes no longer look like raw dumps. Co-authored-by: Cursor --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) (limited to 'README.md') diff --git a/README.md b/README.md index 1261355..5cdd928 100644 --- a/README.md +++ b/README.md @@ -25,6 +25,19 @@ icloud-note update --title "Hello" --body "Revised from Linux" | `icloud-note create` | Headless **new** note (`--title`, `--body` / `--body-file`) | | `icloud-note update` | Headless **update** existing note by title (never creates) | +## Formatting + +Bodies may be plain text or light Markdown. The CLI rewrites them to **Apple Notes +style** before writing: + +- First line = Title; blank line before the rest +- `##` / `###` → Heading / Subheading (no `#` markers) +- `-` / `*` bullets → `•`; `1.` lists kept; `- [ ]` / `- [x]` → ☐ / ☑ +- Inline `**bold**`, links, and outer code fences cleaned up +- Short paragraphs and list blocks spaced like Notes (not a Markdown dump) + +`ICLOUD_NOTES_DRY_RUN=1` prints a formatted preview without touching iCloud. + ## Layout ```text -- cgit v1.2.3