사용법#

Nextcloud 서버 프로필 연결하기#

설정 → Harang Nextcloud를 여세요.
새 프로필 추가에서 다음을 입력하세요:

필드	설명
프로필 이름	이 계정을 나타내는 이름입니다. 예: `Work`, `Personal`. 여러 Nextcloud 계정을 구분하는 데 쓰이며, 아래에서 설명할 폴더 선택 접두어로도 사용됩니다.
서버 URL	Nextcloud 인스턴스의 기본 URL. 예: `https://cloud.example.com`.

로그인하여 연결을 클릭하세요. 브라우저에서 Nextcloud 로그인 페이지가 열리면 그곳에서 로그인하고 연결을 승인하세요.
Obsidian으로 돌아오면 로그인 절차가 완료됐을 때 Nextcloud connection complete 알림이 표시되고, 목록에 서버 URL과 계정명이 함께 표시된 프로필이 나타납니다.

가지고 있는 Nextcloud 계정 수만큼 프로필을 추가할 수 있습니다. 각 프로필 항목에는 앱 비밀번호가 더 이상 작동하지 않을 때 로그인 절차를 다시 실행하는 다시 연결 버튼과 삭제 버튼도 있습니다.

참고

이 플러그인은 Nextcloud 계정 비밀번호를 직접 묻거나 저장하지 않습니다 — Nextcloud 공식 데스크톱/모바일 클라이언트와 동일한 방식인 Login Flow v2 핸드셰이크를 통해 앱 비밀번호를 발급받습니다.

Nextcloud 링크 붙여넣기#

Nextcloud 웹 UI에서 내부 링크를 복사하세요(세부 정보 → 내부 링크 복사, 또는 파일의 “내부 링크 복사” 액션). 다음과 같은 형태입니다:

https://cloud.example.com/f/12345

노트에 붙여넣으면 플러그인이 링크를 인식해 다음으로 바꿉니다:

```nextcloud-file
https://cloud.example.com/f/12345
```

그리고 그 코드 블록을 다음을 보여주는 카드로 렌더링합니다:

폴더/파일을 구분하는 📁/📄 아이콘.
파일의 이름과 전체 경로.
파일 크기와 날짜(서버가 실제로 제공하는 값에 따라 생성일 또는 수정일로 표시됩니다 — 아키텍처 참고), 그리고 매칭된 프로필 이름.
원본 내부 링크를 여는 브라우저에서 열기 버튼.

연결된 프로필 중 어느 서버도 링크와 일치하지 않으면 블록에 대신 오류가 표시됩니다(“No Nextcloud profile matches this link. Add one in settings.”) — 일치하는 프로필을 추가하거나 다시 연결한 뒤 노트를 다시 렌더링하면 해결됩니다.

붙여넣는 대신, 기존 텍스트를 선택하고 명령 팔레트에서 Convert selected Nextcloud internal link to a file block을 실행해 같은 블록으로 바꿀 수도 있습니다.

노트에 첨부 파일 바로 업로드하기#

노트를 업로드 대상으로 만들려면 nc-folder 프런트매터 속성을 추가하세요:

---
nc-folder: Work/Projects/Notes
---

값의 형식은 <프로필이름>/<경로>입니다 — 경로는 해당 프로필의 Nextcloud 파일 루트를 기준으로 하며, 아직 없다면 자동으로 만들어집니다. 프로필이 하나만 등록되어 있다면 프로필 이름을 생략하고 경로만 적어도 됩니다.

이 속성이 설정된 상태에서 이미지가 아닌 파일을 하나 이상 붙여넣으면(이미지는 여전히 일반 Obsidian 첨부 파일로 붙여넣어집니다) 각 파일이 해당 폴더로 업로드되고 nextcloud-file 블록이 삽입됩니다 — 내부 링크를 붙여넣었을 때와 동일한 블록입니다. 대상 폴더에 같은 이름의 파일이 이미 있으면 사용 가능한 이름이 자동으로 선택됩니다(report (1).pdf, report (2).pdf 등).

첨부 링크 제거하기#

Obsidian이 열려 있는 동안 노트에서 nextcloud-file 블록을 삭제하거나(또는 노트 자체를 삭제하면) 실제 파일도 Nextcloud 휴지통으로 옮길지, 그대로 둘지 플러그인이 물어봅니다. 이는 현재 세션 동안 Obsidian이 실제로 열거나 수정한 노트에 대해서만 적용됩니다 — 정확한 추적 동작은 아키텍처를 참고하세요.