저는 옵시디언을 활용해 블로그를 무료로 퍼블리시하고자 이 과정을 직접 확인해보았어요. 이 글을 통해 여러분께는 옵시디언을 쉽게 웹에 게시할 수 있는 방법을 자세히 안내하려고 해요. Cloudflare, Quartz, 그리고 Flowershow Plugin을 활용하면 무료로 훌륭한 결과를 만들 수 있다는 것을 알려드리고 싶어요.
1. 준비 단계: 필요한 계정 만들기
옵시디언을 웹에 퍼블리시하기 위해서는 몇 가지 준비 작업이 필요해요. 제가 직접 확인해본 바로는 다음의 두 가지 계정을 사전에 만들어야 합니다.
A. GitHub 계정 생성하기
– GitHub 계정이 없다면, 여기에서 즉시 계정을 생성할 수 있어요.
B. Cloudflare 계정 만들기
- Cloudflare 계정도 필요하다는 것을 잊지 말아야 해요. 여기에서 쉽게 가입할 수 있답니다.
2. GitHub에서 Quartz 저장소 생성
이제 본격적으로 GitHub에 새로운 Quartz 저장소를 생성해볼까요? 제가 직접 경험해본 결과, 아래의 과정이 필요해요.
- GitHub의 Quartz 페이지에 방문하여 ‘Use this template’ 버튼을 클릭합니다.
- ‘Create a new repository’ 옵션을 선택하고 원하는 ‘Repository Name’을 입력한 후, ‘Create Repository’ 버튼을 클릭합니다.
| 단계 | 설명 |
|---|---|
| 1. GitHub 페이지 방문 | Quartz GitHub 페이지로 이동합니다. |
| 2. 템플릿 선택 | ‘Use this template’ 버튼 클릭, ‘Create a new repository’ 선택 |
| 3. 저자 영역 입력 | ‘Repository Name’ 입력 후 ‘Create Repository’ 클릭 |
이렇게 저장소를 생성하게 되면, 이후 Cloudflare를 이용해 연결할 수 있어요.
3. Cloudflare에 GitHub 연결하기
이 단계에서는 Cloudflare와 GitHub 계정을 연결하는 과정이에요. 제가 알아본 바로는 아래의 단계가 필요합니다.
- Cloudflare 대시보드에 접속하여 ‘Workers 및 Pages로 응용 프로그램을 빌드’ 링크를 클릭해요.
- ‘Pages’ 탭에서 방금 생성한 GitHub 저장소를 연결하기 위한 목록에서 선택합니다.
A. 프로젝트 이름 입력하기
- 연결과정에서 프로젝트 이름을 입력하는 단계가 필요하고, 이 이름은 이후 도메인과 연결될 거예요.
B. 빌드 설정 조정하기
- 빌드 설정에 들어가 ‘프레임워크 미리 설정’을 ‘없음’으로 설정하고, ‘빌드 명령’에
npx quartz build라고 입력해요. - 마지막으로 ‘빌드 출력 디렉토리’에
public을 입력하면 됩니다.
4. 옵시디언 노트를 웹에 게시하기
이제 옵시디언에 저장한 노트를 웹에 게시하는 단계가 남았어요. 제가 실제로 경험했을 때, Flowershow 플러그인 사용이 정말 유용하더라고요.
- Flowershow 플러그인 설치: 먼저, 옵시디언에 Flowershow 플러그인을 설치합니다.
- 노트 업로드: 이후 ‘Flowershow: Publish Single Note’ 명령을 실행하면, 원하는 노트가 GitHub 저장소에 업로드됩니다.
| 기능 | 설명 |
|---|---|
| 플러그인 설치 | 옵시디언에서 Flowershow 플러그인 설치 |
| 노트 업로드 | ‘Publish Single Note’ 명령으로 노트 업로드 |
노트를 업로드 후에는 리본 아이콘 🌱을 클릭하여 업데이트된 노트를 다시 업로드하거나 삭제할 수 있는 옵션이 있어요.
5. 오류 처리 및 마무리
게시한 후 “404 Either this page is private or doesn’t exist.” 메시지를 확인하면, content 폴더에 index.md 파일이 없는 문제일 수 있어요. 이 경우:
- index.md 파일 생성: 해당 폴더에
index.md파일을 생성해 주셔야 해요. 만약 방법을 모르신다면, 제 깃허브 블로그 저장소를 참조하시면 됩니다.
마지막으로 제가 만든 블로그 URL을 소개해 드릴게요: anpigon.pages.dev. Quartz, Flowershow 플러그인, 그리고 Cloudflare를 통해 정말 쉽게 만들어졌어요.
자주 묻는 질문 (FAQ)
GitHub 계정 없으면 어떻게 해야 하나요?
GitHub 계정을 꼭 만들어야 해요. 계정 만들기가 어렵지 않아서, 쉽게 가입할 수 있어요.
Cloudflare는 왜 필요한가요?
Cloudflare를 통해 노트를 안전하고 쉽게 웹에 퍼블리시할 수 있어요.
Flowershow 플러그인 설치가 어려운가요?
아니요, 아주 간단하게 설치할 수 있어요. 옵시디언의 플러그인 관리에서 손쉽게 설치할 수 있답니다.
퍼블리시 후 수정은 어떻게 하나요?
퍼블리시된 노트의 수정은 Flowershow 플러그인의 리본 아이콘을 통해 쉽게 관리할 수 있어요.
제가 직접 경험한 내용을 바탕으로, 이 과정을 통해 옵시디언을 무료로 퍼블리시하는 방법을 알려드렸어요. 여러 단계가 있지만, 한번 익히고 나면 이후에는 쉽게 사용할 수 있답니다.
태그: 옵시디언, 무료퍼블리시, Cloudflare, Quartz, Flowershow Plugin, GitHub, 블로그작성, 노트퍼블리싱, 생산성툴, 웹개발, 플러그인