commonnote:// 딥링크
commonnote:// 링크 하나로 앱의 캘린더, 대시보드, 노트, 업무를 바로 엽니다. 위젯이 쓰는 바로 그 링크입니다.
이용 조건 Mac 앱 · iPhone 앱 · 브라우저는 https 주소로
commonnote://로 시작하는 링크는 CommonNote 앱을 열고 특정 화면으로 곧장 보냅니다. 위젯을 눌렀을 때 쓰는 것과 같은 링크여서, 단축어나 런처, 다른 앱의 링크, 스크립트에서도 같은 방식으로 쓸 수 있습니다.
링크 형식
| 링크 | 여는 화면 |
|---|---|
commonnote://calendar?view=timegrid&day=2026-09-28 | 캘린더. view는 timegrid(시간표, 기본), calendar(월 달력), table(표). day는 YYYY-MM-DD이고 빼면 이미 열려 있던 캘린더는 보던 날짜를 그대로 두고, 새로 연 캘린더는 오늘에서 시작합니다. |
commonnote://dashboard | 대시보드 |
commonnote://note?id=<노트-id> | 그 노트 |
commonnote://task?note=<노트-id>&task=<업무-id> | 할 일 화면에서 그 업무 |
- 형식이 맞지 않거나 알 수 없는 링크는 무시됩니다. 날짜가 형식에 맞지 않으면 날짜를 뺀 것과 같이 다룹니다.
- 링크는 2,048바이트 이하여야 하고 제어 문자를 넣을 수 없습니다.
- 앱이 꺼져 있으면 앱이 켜진 뒤 그 화면으로 갑니다.
- 노트 id는 노트 목록에서 우클릭 → 공유 링크 복사로 얻은 주소의
?note=뒤, 또는 마크다운 API 목록 응답의id에 있습니다. 업무 id는 주로 위젯이 쓰는 값입니다.
해 보기
- 맥 앱을 설치합니다(맥 앱 쓰기).
- 터미널에서
open "commonnote://calendar?view=calendar"를 실행합니다. - CommonNote가 앞으로 나오며 월 달력이 열립니다.
아이폰에서는 단축어 앱의 URL 열기 동작에 같은 링크를 넣으면 됩니다. 아이폰 앱은 지금 App Store 심사 중입니다(아이폰 앱과 Live Activity).
브라우저에서는
commonnote:// 링크는 앱이 설치된 기기에서만 열립니다. 브라우저의 웹 앱에서는 아래 주소가 같은 일을 합니다.
| 앱 링크 | 웹 주소 |
|---|---|
commonnote://note?id=… | https://commonnote.app/?note=… |
commonnote://calendar?view=timegrid&day=… | https://commonnote.app/?calendar=timegrid&day=… |
링크는 화면을 여는 것일 뿐 권한을 주지 않습니다. 볼 권한이 없는 노트의 링크를 받으면 열리지 않습니다. 노트를 함께 보려면 공유하세요.