Pandoc Reference List: Citations Đẹp trong Obsidian | Research Tools
Bạn đang viết draft trong Obsidian, cần cite một paper. Gõ [@nguyen2024] xong nhìn lại thấy... vẫn là [@nguyen2024]. Không biết đó là paper nào, format citation ra sao.
Pandoc Reference List giải quyết vấn đề này - chuyển [@citekey] thành (Nguyen et al., 2024) ngay trong Obsidian, kèm panel hiển thị references formatted theo APA/IEEE.
Bài này yêu cầu đã setup ZotLit và Better BibTeX. Xem bài Foundation nếu chưa.
Pandoc Reference List làm gì?
| Tính năng | Mô tả |
|---|---|
| 📋 References Panel | Sidebar hiển thị references formatted (APA, IEEE...) |
| ✨ Inline Rendering | [@citekey] → (Author et al., 2024) |
| 🔍 Autocomplete | Gợi ý citations khi gõ [@ |
| 🔗 DOI Links | Links clickable trong panel |
Cài đặt Pandoc
Pandoc là engine xử lý citations. Cần cài riêng trước khi dùng plugin.
macOS: Truy cập github.com/jgm/pandoc/releases, tải file .pkg phù hợp - Mac M1/M2/M3 chọn arm64, Mac Intel chọn x86_64. Double-click để cài.
Windows: Tải file .msi từ cùng trang, chạy installer.
Kiểm tra: Mở Terminal/Command Prompt:
pandoc --version
# Output: pandoc 3.x.x
which pandoc # macOS
# Output: /usr/local/bin/pandoc
Export Bibliography từ Zotero
Plugin cần file .bib chứa tất cả references.
Trong Zotero: File → Export Library → Format: Better BibLaTeX → tick "Keep updated" → Save vào 5 - Template/ZotLit/My_Library.bib
"Keep updated" quan trọng - file .bib tự động cập nhật khi thêm papers mới vào Zotero.
Download Citation Style
Truy cập zotero.org/styles, tìm "apa", click American Psychological Association 7th edition để download.
Di chuyển file apa.csl vào 5 - Template/ZotLit/apa.csl
Cài đặt Plugin
Settings → Community plugins → Browse → tìm "Pandoc Reference List" → Install → Enable.
Cấu hình Plugin
Vào Settings → Pandoc Reference List:
| Setting | Giá trị |
|---|---|
| Fallback path to Pandoc | /usr/local/bin/pandoc (macOS) hoặc path từ where pandoc (Windows) |
| Path to bibliography file | 5 - Template/ZotLit/My_Library.bib |
| Custom citation style | 5 - Template/ZotLit/apa.csl |
Bật các options:
- ✅ Render live preview inline citations
- ✅ Render reading mode inline citations
- ✅ Show citekey suggestions
Sử dụng Citations
Chèn citation: Gõ [@ trong note → autocomplete hiện ra → chọn paper → Enter.
Theo nghiên cứu của [@nguyen2024sustainable], sustainable packaging...
Kết quả:
| Mode | Hiển thị |
|---|---|
| Edit mode | [@nguyen2024sustainable] |
| Live Preview | (Nguyen et al., 2024) |
| Reading mode | (Nguyen et al., 2024) |
References Panel: Cmd/Ctrl + P → "Pandoc Reference List: Show reference list" → Panel sidebar hiển thị tất cả citations trong note, formatted theo APA với DOI links.
Troubleshooting
| Vấn đề | Giải pháp |
|---|---|
| "No citations found" | Kiểm tra path .bib có đầy đủ extension không |
| Citation không render | Citekey phải khớp chính xác với file .bib |
| Autocomplete không hiện | Bật "Show citekey suggestions" trong settings |
| Paper mới không hiện | Đợi Zotero sync (nếu đã bật Keep updated) |
Resources
Bài tiếp theo: Dataview Dashboard - Quản lý papers như database
Bài trước: ZotLit Templates - Color-Coding System
Series: Research Tool Stack