summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorChristopher Warner <cwarner@kernelcode.com>2026-10-10 18:56:14 -0400
committerChristopher Warner <cwarner@kernelcode.com>2026-10-10 18:56:14 -0400
commitce524225a4c74aed82813b9bc067fd54c8160516 (patch)
treee320077b0c1f1ec7be972694cb29ef654b648f94 /README.md
parentf0c2eecc2c53f9bea72783cc376a337892b5a392 (diff)
downloadiphone-notes-ce524225a4c74aed82813b9bc067fd54c8160516.tar.gz
iphone-notes-ce524225a4c74aed82813b9bc067fd54c8160516.tar.bz2
iphone-notes-ce524225a4c74aed82813b9bc067fd54c8160516.tar.xz
iphone-notes-ce524225a4c74aed82813b9bc067fd54c8160516.zip
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 <cursoragent@cursor.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md13
1 files changed, 13 insertions, 0 deletions
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