/obsidian-tistory-plugin

옵시디언(Obsidian) 티스토리 플러그인

Primary LanguageTypeScriptMIT LicenseMIT

Obsidian Tistory Plugin (unofficial)

GitHub Workflow Status GitHub release (latest SemVer) GitHub all release Downloads License Hits

옵시디언 에디터에서 티스토리에 글을 등록하고 수정할 수 있습니다.
아직 개발 중인 앱입니다. 버그나 개선사항이 있다면 Issues에 남겨주세요.

You can create and edit posts on Tistory from the Obsidian Editor.
This app is still in development. If you have any bugs or improvements, please leave them in Issues.

☕️ 후원하기

커피 한 잔의 값으로 개발을 지원할 수 있습니다.
You can support development for the price of a cup of coffee.


[카카오페이로 후원하기] [토스페이로 후원하기]


📍 Changelog

v0.8.4

  • 일부 매타태그 삽입되는 버그 수정
  • 기타 코드 개선

v0.7.2

  • 블로그 푸터 옵션 기능 추가

v0.6.2

  • 코드 블럭 개선

v0.5.0

  • 가능하면 내부 링크를 티스토리 링크로 변환하도록 개선
  • 글 발행할 때 마다 첫 줄에 빈라인이 계속 삽입되는 현상 버그 수정

v0.4.0

  • 글 예약 발행 기능 추가

v0.3.0

  • 글 태그 입력 기능 추가
  • UI 개선 및 일부 버그 수정

🚀 설치하기

  • 방법 #1: OBSIDIAN42 - BRAT를 사용하여 플러그인을 설치합니다. "Add Beta Plugin"]" 버튼을 눌러 anpigon/obsidian-tistory-plugin 를 입력합니다.
  • 방법 #2: GitHub release (latest by SemVer and asset including pre-releases) 최신 릴리스에서 Assets(main.js, manifest.json, styles.css)를 다운로드 합니다. 그리고 옵시디언 볼트의 .obsidian/plugins 경로에 tistory 폴더를 생성하고 다운로드 받은 파일 3개를 넣어줍니다.

⚙️ 티스토리 플러그인 설정하기

옵시디언 설정 > 서드파티 플러그인 > Tistory에서 "인증하기" 버튼을 누릅니다.


티스토리 인증에 성공하면, 글을 발행할 티스토리 블로그를 선택합니다.


✍️ 티스토리에 글 발행하는 방법

글을 작성한 에디터 창에서 명령어 팔레트(Cmd + P)를 실행하고, "Tistory: Publish to Tistory"를 선택합니다.

티스토리 글 발행을 더 간편하게 사용하고 싶으면 해당 명령어에 단축키를 지정하면 됩니다. 단축키를 지정하는 방법은 단축키 지정하기에서 설명합니다.


그 다음 "티스토리 글 발행" 모달 팝업이 나타나면 속성을 확인하고 "발행하기" 버튼을 선택합니다.

티스토리 글 업로드가 성공하면 메타데이터가 프론트매터(Frontmatter)에 자동 추가됩니다.

자동으로 추가된 프론트매터는 글을 수정할 때 사용되는 데이터이므로 절대 삭제하면 안됩니다.
프론트매터에 추가된 데이터 속성에 대해서는 아래에서 설명합니다.

🗄️ 프론트메터 속성

속성 설명
tistoryBlogName 블로그 이름
tistoryTitle 글 제목
tistoryTags 태그(쉼표로 구분)
tistoryVisibility 발행상태 (0: 비공개, 3: 발행)
tistoryCategory 글 카테고리 ID
tistoryPostId 글 Post ID (글 수정시 필요)
tistoryPostUrl 글 URL
tistoryPublished 발행 예약일 (yyyy-MM-ddTHH:mm)
tistorySkipModal 다음 발행부터 모달창 띄우지 않기 (true, false)

⌘ 단축키 지정하기

단축키를 지정하고 싶으면 옵시디언 설정 > 단축키에서 "Tistory: Publish to Tistory"를 찾아 원하는 단축키를 설정합니다.


🤝 추가 내용

  • 현재 티스토리 플러그인은 노트에 포함된 내부 이미지를 Base64 encoded data 형태로 블로그 내용에 포함하여 업로드하고 있습니다.
  • 이슈 #2 에서 알려진 바와 같이 용량이 큰 이미지가 포함된 글을 발행하면 "글자수 초과 에러"가 발생합니다.
  • 이 문제는 해결할 계획입니다. 당분간 이미지 업로드에 옵시디언 Imgur 플러그인을 사용을 권장합니다.

📆 계획된 기능

  • 티스토리 이미지 업로드 기능
  • 티스토리 블로그 목록 가져오기 및 검색
  • 타 플러그인 렌더링 지원