도움말 문서

MarkFlow를 최대한 활용할 수 있도록 도와주는 포괄적인 가이드와 튜토리얼

시작하기

3단계로 MarkFlow 시작하기

1

MarkFlow 다운로드 및 설치

공식 웹사이트에서 운영 체제에 적합한 버전을 다운로드하고 설치를 완료하세요

2

Notion API Key 구성

설정 페이지에서 Notion API Key와 대상 페이지 URL을 입력하세요

3

폴더 선택 및 동기화 시작

마크다운 파일이 포함된 폴더를 선택하고 미리보기 후 동기화를 시작하세요

기능 가이드

수동 동기화

파일을 수동으로 선택하고 Notion에 동기화합니다. 동기화 내용을 정확하게 제어하며, 그래픽 인터페이스로 작업을 직관적으로 만듭니다.

  • 파일 선택
  • 미리보기 기능
  • 실시간 진행률

자동 동기화

지능형 파일 모니터링, 사용자 정의 가능한 동기화 타이밍. 파일 변경이 Notion에 자동 동기화를 트리거합니다.

  • 파일 모니터링
  • 자동 트리거
  • 상태 표시

구성 관리

안전한 계정 연결, 연결 테스트, 페이지 구성. 한 번 설정하면 영원히 사용할 수 있습니다.

  • API Key 구성
  • 연결 테스트
  • 안전한 저장

기록 추적

완전한 동기화 기록, 통계 분석, 검색 필터링. 모든 작업을 추적 가능하게 만듭니다.

  • 동기화 기록
  • 통계 분석
  • 검색 필터링

구성 가이드

Notion API Key 얻는 방법

  1. Notion 개발자 페이지 방문 Notion 개발자 페이지
  2. "새 통합"을 클릭하여 새 통합 앱 생성
  3. 통합 이름(예: "MarkFlow") 입력 및 작업 공간 선택
  4. 생성된 "Internal Integration Token" 복사
  5. 이 토큰을 MarkFlow 설정에 붙여넣기

페이지 권한 설정

  1. Notion에서 대상 페이지 열기
  2. 페이지 오른쪽 상단의 "공유" 버튼 클릭
  3. "초대" 섹션에서 생성한 통합 이름 검색
  4. 통합을 선택하고 "초대" 클릭
  5. 통합에 "편집" 권한이 있는지 확인

문제 해결

동기화 실패, "API Key 무효" 표시

다음 사항을 확인해 주세요:

  • API Key가 여분의 공백 없이 완전히 복사되었는지 확인
  • API Key가 만료되었는지 확인
  • 통합 앱 상태가 정상인지 확인
Notion 페이지에 액세스할 수 없음

가능한 해결책:

  • 페이지 URL이 올바른지 확인
  • 통합이 페이지에 초대되었는지 확인
  • 통합에 편집 권한이 있는지 확인
자동 동기화가 작동하지 않음

가능한 해결책:

  • 폴더 경로가 올바른지 확인
  • 자동 동기화 기능이 활성화되어 있는지 확인
  • 애플리케이션 재시작