Notion이
텍스트와 HTML을 복사하는 방법.

복사 작업은 어디로 이어질까요?

페이지에는 clipboard.write 메서드가 보입니다. 프리로드의 실제 구현은 래퍼입니다. 이 래퍼가 무엇을 보내고 어느 코드가 받는지 살펴보는 것이 핵심입니다.

에이전트가 로컬 Notion 앱 패키지에 접근할 수 있는 상태에서 사용하는 예제 프롬프트입니다.

REA로 읽기 시작할 위치 찾기

REA로 탭 프리로드를 분석하면 페이지에 노출된 API와 IPC 요청 호출을 찾습니다. 두 결과에는 압축된 번들의 소스 범위가 함께 제공됩니다:

api_key: "__electronApi"
api_status: "dynamic"
source: preload.js:1:22764–22828

operation: "invoke"
channel_expression: "e"
source: preload.js:1:6486–6522

에이전트는 해당 위치를 열고, 조합된 API에서 clipboard 멤버를 찾아 invokerInMain를 읽습니다. 이 함수의 호출 지점에서는 notion:clipboard:write을 전달합니다. 이 이름 덕분에 에이전트는 메인 번들에서 무엇을 찾아야 할지 정확히 알 수 있습니다. 아래 네 발췌문은 에이전트가 연결한 경로를 보여줍니다.

네 개의 짧은 코드 조각

패키징된 JavaScript를 읽기 쉬운 변수 이름으로 단순화했습니다. 관련 없는 멤버는 생략했습니다.

1. 페이지에 노출된 API에서 시작

   tab_browser_view/preload.js · API 멤버 복사

   const clipboardApi = {
     write: invokerInMain("notion:clipboard:write")
   };
   
   // Included in the API exposed through contextBridge:
   // window.__electronApi.clipboard

   이 멤버는 채널 이름을 제공합니다. invokerInMain의 구현을 보면 요청이 페이지의 프로세스에서 어떻게 전달되어 나가는지 알 수 있습니다.

2. 프리로드 래퍼의 구현 추적

   tab_browser_view/preload.js · IPC 보조 함수 복사

   function invokerInMain(channel) {
     return (...args) => invokeInMainAndReturnResult(channel, ...args);
   }
   
   function invokeInMainAndReturnResult(channel, ...args) {
     return ipcRenderer.invoke(channel, ...args);
   }

   반환된 함수는 Electron의 요청·응답 IPC로 인수를 전달합니다. 이제 메인 프로세스에서 notion:clipboard:write을 찾을 수 있습니다.

3. 수신 핸들러 등록 방식 확인

   main/index.js · 핸들러 도우미 복사

   const handleRequestFromRenderer = {
     addListener(channel, handler) {
       ipcMain.handle(channel, handler);
     }
   };

   메인 프로세스도 래퍼를 사용합니다. addListener 메서드가 해당 채널에 ipcMain.handle 수신 핸들러를 등록합니다.

4. 쓰기 호출과 발신자 검사 찾기

   main/index.js · 클립보드 수신 측 복사

   handleRequestFromRenderer.addListener(
     "notion:clipboard:write",
     (event, data) =>
       isNotionWebContents(event.sender)
         ? clipboard.write(data)
         : undefined
   );

   여기가 최종 도착점입니다. 발신자를 확인한 뒤 핸들러는 전달받은 데이터를 Electron 클립보드 API에 넘깁니다. 채널과 두 래퍼의 구현을 통해 노출된 메서드와 이 호출이 연결됩니다.

복사한 블록은 구조를 어떻게 유지할까요?

Notion의 웹 편집기는 electronApi.clipboard.write를 통해 텍스트와 HTML을 보냅니다. 블록 데이터는 로컬에 유지하고, 복사한 HTML에 ID를 넣어 둘을 연결합니다.

text: "Project notes"
html: "<p>Project notes</p>"
    + "<!-- notionvc: <copy-id> -->"

id: <copy-id>
mimeTypes:
  text/_notion-blocks-v3-production
    → structured block data

붙여넣을 때 Notion은 HTML의 ID를 찾아 저장된 사본과 대조합니다. ID가 일치하면 블록 데이터를 복원합니다.

2026년 7월 13일 캐시된 웹 자산에서 기록한 클립보드 형식입니다.

추가 예제와 출처

| A | B |
| - | - |
| 1 | 2 |

table · headerRow: true
  table_row
    cells: ["A"], ["B"]
  table_row
    cells: ["1"], ["2"]

• JavaScript 앱 가이드작은 Electron 앱의 내보내기 기능을 추적합니다.
• DX-Ball 재구성네이티브 명령어에서 검증된 C 함수까지 추적합니다.