Writing Asset

approved

by creative781

Link local files into an asset group and insert them while writing. - This plugin has not been manually reviewed by Obsidian staff.

↓ 36 downloadsUpdated 28d agoMIT
Install in ObsidianView on GitHub

Writing Asset

Link files on your computer (photos, figures, spreadsheets, PDFs, and more) to Obsidian notes without copying them into the vault. Each asset group (asset-group by default) has one catalog note that stores metadata. Writing notes that share the same group value see the same asset browser.

Desktop only (uses Electron dialogs and Node file access).

Features

  • Asset groups — One catalog per group; many writing notes can share it
  • Register local files — Pick files or drag-and-drop from Finder / File Explorer into the asset window
  • Categories — Photo, Figure, Table, Document, Other
  • Insert by id — Notes store a writing-asset code block with an id (not a fragile absolute path). Update the catalog once; every note that uses that id updates
  • Embed or link — Images (and audio/video) can render in the note; PDFs, Office files, and similar open as title links with optional description / kind badge
  • Edit after insert — Change title, description, and category from the pencil control or Edit info; already-inserted blocks refresh
  • Relocate & bulk path fix — When files move, relocate one item or rewrite path prefixes for a whole group
  • Export folder — Copy related notes and assets into Notes/, Assets/, plus catalog.md and README.md
  • Print / PDF options — Images only, or all linked asset info (works with Obsidian print and companions such as Beautiful PDF)

Commands

CommandDescription
Writing Asset: Browse assetsOpen the asset browser for the current note’s group (ribbon: paperclip)
Writing Asset: Register filesAdd files from a system file dialog
Writing Asset: Assign asset group to this noteSet or create the note’s asset-group
Writing Asset: Export this group to a folderExport notes + assets for the group

Settings

  • Asset group property — Frontmatter key shared by writing notes and catalogs (default asset-group)
  • Catalog note folder — Where new catalog notes are created (empty = vault root)
  • Asset root folder — Preferred PC folder for research files; paths under this root are stored relatively
  • When exporting to PDF — Images only / All linked assets
  • Link card style — Normal / Simple / Very simple, plus toggles for title, filename, description, and kind

Usage

  1. On a writing note, set:
---
asset-group: dissertation
---

Or run Assign asset group to this note.

  1. Open Browse assets (or the paperclip ribbon). Add files with Add files or drag them onto the window.
  2. Select an item → Insert into note or Insert link only.
  3. To change title or description later, use Edit info in the browser or the pencil / paperclip on the in-note card.

Inserted blocks look like:

id: sketch-03
group: dissertation
mode: embed

Installation

Community plugins (after approval)

Search for Writing Asset in Obsidian Settings → Community plugins.

Manual installation

  1. Download main.js, manifest.json, and styles.css from the latest release.
  2. Create a folder named writing-asset inside your vault’s .obsidian/plugins/ directory.
  3. Place the downloaded files in that folder.
  4. Enable the plugin in Obsidian settings (desktop).

BRAT (beta)

  1. Install the BRAT plugin.
  2. Add beta plugin: https://github.com/Creative781/writing-asset

Develop

npm install
npm run build

Copy or symlink this folder to .obsidian/plugins/writing-asset/ (needs manifest.json, main.js, styles.css).

License

MIT

Connect

Support

Writing Asset (한국어)

컴퓨터에 있는 파일(사진, 그림, 엑셀, PDF 등)을 옵시디안 글과 볼트에 복사하지 않고 연결합니다. 자료 묶음(asset-group, 설정에서 이름 변경 가능)마다 목록 노트 하나에 메타데이터를 두고, 같은 묶음 값을 가진 글 노트는 같은 자료 화면을 봅니다.

데스크톱 전용입니다 (Electron 대화상자·Node 파일 접근).

기능

  • 자료 묶음 — 묶음당 목록 노트 하나, 여러 글 노트가 공유
  • 로컬 파일 등록 — 파일 선택 또는 탐색기에서 자료 창으로 드래그 앤 드롭
  • 카테고리 — 사진, 그림, 표, 문서, 기타
  • id로 삽입 — 본문에는 절대 경로 대신 writing-asset 코드 블록의 id. 목록만 고치면 같은 id를 쓰는 노트에 반영
  • 임베드 / 링크 — 이미지·음성·영상은 본문에 표시 가능, PDF·Office 등은 제목 링크(+ 설명·종류 뱃지)
  • 넣은 뒤에도 수정 — 연필 / 정보 수정으로 제목·설명·종류 변경, 이미 넣은 블록도 갱신
  • 다시 찾기·경로 일괄 수정 — 파일 이동 시 항목별 또는 접두어 일괄 수정
  • 폴더로 내보내기 — Notes/, Assets/, catalog.md, README.md로 복사
  • 인쇄·PDF 옵션 — 이미지만 / 모든 연결 자료 정보 (옵시디안 인쇄 및 Beautiful PDF 등과 함께 사용)

명령

명령설명
Writing Asset: Browse assets현재 노트 묶음의 자료 보기 (리본: 클립)
Writing Asset: Register files시스템 파일 대화상자로 등록
Writing Asset: Assign asset group to this note이 노트에 asset-group 지정
Writing Asset: Export this group to a folder묶음의 노트·자료 내보내기

설정

  • Asset group property — 글 노트와 목록이 공유하는 속성 키 (기본 asset-group)
  • Catalog note folder — 새 목록 노트 위치 (비우면 볼트 루트)
  • Asset root folder — 연구 자료용 PC 폴더. 루트 안은 상대 경로로 저장
  • When exporting to PDF — Images only / All linked assets
  • Link card style — Normal / Simple / Very simple + 제목·파일명·설명·종류 토글

사용

  1. 글 노트에 속성을 두거나 Assign asset group to this note를 실행합니다.
---
asset-group: dissertation
---
  1. Browse assets(또는 클립 리본)를 연 뒤 Add files 또는 창으로 드래그해 등록합니다.
  2. 항목을 고른 뒤 Insert into note 또는 Insert link only.
  3. 제목·설명은 나중에 Edit info 또는 본문 카드의 연필/클립으로 고칩니다.

본문 블록 예:

id: sketch-03
group: dissertation
mode: embed

설치

커뮤니티 플러그인 (승인 후)

옵시디안 설정 → 커뮤니티 플러그인에서 Writing Asset을 검색합니다.

수동 설치

  1. 최신 릴리스에서 main.js, manifest.json, styles.css를 받습니다.
  2. 볼트의 .obsidian/plugins/ 아래에 writing-asset 폴더를 만듭니다.
  3. 받은 파일을 그 폴더에 넣습니다.
  4. 옵시디안 설정에서 플러그인을 켭니다 (데스크톱).

BRAT (베타)

  1. BRAT 플러그인을 설치합니다.
  2. 베타 플러그인으로 https://github.com/Creative781/writing-asset 을 추가합니다.

개발

npm install
npm run build

이 폴더를 .obsidian/plugins/writing-asset/에 복사하거나 심볼릭 링크합니다 (manifest.json, main.js, styles.css 필요).

라이선스

MIT

연결

후원

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.