引用匯出指南
描述
引用匯出現在統一使用 prepare_export。最常見的做法是先搜尋,再用 pmids="last" 匯出上一輪搜尋結果;若只想匯出指定文章,則直接傳 PMID 清單。
快速決策樹
需要匯出引用?
├── EndNote / Zotero / Mendeley → prepare_export(pmids="last", format="ris")
├── LaTeX / Overleaf → prepare_export(pmids="last", format="bibtex", source="local")
├── Excel / 分析 → prepare_export(pmids="last", format="csv", source="local")
└── 程式處理 → prepare_export(pmids="last", format="csl")
核心工具
prepare_export(
pmids="last",
format="ris",
include_abstract=True,
source="official"
)
pmids 可接受
"last"
"12345678,87654321"
["12345678", "87654321"]
"PMID:12345678"
來源與格式
| source |
支援格式 |
何時用 |
official |
ris, medline, csl |
預設首選,品質最好 |
local |
ris, bibtex, csv, medline, json |
需要 BibTeX、CSV 或離線替代 |
常用格式
| 用途 |
呼叫方式 |
| EndNote / Zotero / Mendeley |
prepare_export(pmids="last", format="ris") |
| LaTeX / Overleaf |
prepare_export(pmids="last", format="bibtex", source="local") |
| Excel / 數據分析 |
prepare_export(pmids="last", format="csv", source="local") |
| 程式處理 |
prepare_export(pmids="last", format="csl") |
| MEDLINE / NBIB 交換 |
prepare_export(pmids="last", format="medline") |
常見工作流程
1. 搜尋後直接匯出
unified_search(query="remimazolam ICU sedation", limit=30)
prepare_export(pmids="last", format="ris")
2. 匯出指定 PMID
prepare_export(
pmids="30217674,28523456,35678901",
format="ris"
)
3. 匯出 BibTeX 給 LaTeX
prepare_export(
pmids="last",
format="bibtex",
source="local"
)
4. 同一批結果同時輸出兩種格式
prepare_export(pmids="last", format="ris")
prepare_export(pmids="last", format="csv", source="local")
建議搭配工具
先確認上次搜尋結果有哪些 PMID
get_session_pmids()
要先看文章細節再決定是否匯出
fetch_article_details(pmids="12345678,87654321")
回傳結果你要關注什麼
status
article_count
format
source
export_text
如果是較大量匯出,回傳也可能包含可下載的檔案路徑或檔案資訊。
實務建議
- 不確定時,先用
format="ris", source="official"
- 只有 BibTeX 需要
source="local"
- 若要保留摘要,維持
include_abstract=True
- 若只要少數重點文章,不要直接匯出整個
last,改傳明確 PMID 清單
1---2name: pubmed-export-citations3description: Export citations with prepare_export. Triggers: 匯出, export, RIS, BibTeX, EndNote, Zotero, Mendeley, 引用格式, reference manager4---56# 引用匯出指南78## 描述910引用匯出現在統一使用 `prepare_export`。最常見的做法是先搜尋,再用 `pmids="last"` 匯出上一輪搜尋結果;若只想匯出指定文章,則直接傳 PMID 清單。1112---1314## 快速決策樹1516```text17需要匯出引用?18├── EndNote / Zotero / Mendeley → prepare_export(pmids="last", format="ris")19├── LaTeX / Overleaf → prepare_export(pmids="last", format="bibtex", source="local")20├── Excel / 分析 → prepare_export(pmids="last", format="csv", source="local")21└── 程式處理 → prepare_export(pmids="last", format="csl")22```2324---2526## 核心工具2728```python29prepare_export(30 pmids="last",31 format="ris",32 include_abstract=True,33 source="official"34)35```3637### `pmids` 可接受3839- `"last"`40- `"12345678,87654321"`41- `["12345678", "87654321"]`42- `"PMID:12345678"`4344---4546## 來源與格式4748| source | 支援格式 | 何時用 |49| ---------- | ----------------------------------------- | --------------------------- |50| `official` | `ris`, `medline`, `csl` | 預設首選,品質最好 |51| `local` | `ris`, `bibtex`, `csv`, `medline`, `json` | 需要 BibTeX、CSV 或離線替代 |5253### 常用格式5455| 用途 | 呼叫方式 |56| --------------------------- | --------------------------------------------------------------- |57| EndNote / Zotero / Mendeley | `prepare_export(pmids="last", format="ris")` |58| LaTeX / Overleaf | `prepare_export(pmids="last", format="bibtex", source="local")` |59| Excel / 數據分析 | `prepare_export(pmids="last", format="csv", source="local")` |60| 程式處理 | `prepare_export(pmids="last", format="csl")` |61| MEDLINE / NBIB 交換 | `prepare_export(pmids="last", format="medline")` |6263---6465## 常見工作流程6667### 1. 搜尋後直接匯出6869```python70unified_search(query="remimazolam ICU sedation", limit=30)71prepare_export(pmids="last", format="ris")72```7374### 2. 匯出指定 PMID7576```python77prepare_export(78 pmids="30217674,28523456,35678901",79 format="ris"80)81```8283### 3. 匯出 BibTeX 給 LaTeX8485```python86prepare_export(87 pmids="last",88 format="bibtex",89 source="local"90)91```9293### 4. 同一批結果同時輸出兩種格式9495```python96prepare_export(pmids="last", format="ris")97prepare_export(pmids="last", format="csv", source="local")98```99100---101102## 建議搭配工具103104### 先確認上次搜尋結果有哪些 PMID105106```python107get_session_pmids()108```109110### 要先看文章細節再決定是否匯出111112```python113fetch_article_details(pmids="12345678,87654321")114```115116---117118## 回傳結果你要關注什麼119120- `status`121- `article_count`122- `format`123- `source`124- `export_text`125126如果是較大量匯出,回傳也可能包含可下載的檔案路徑或檔案資訊。127128---129130## 實務建議131132- 不確定時,先用 `format="ris"`, `source="official"`133- 只有 BibTeX 需要 `source="local"`134- 若要保留摘要,維持 `include_abstract=True`135- 若只要少數重點文章,不要直接匯出整個 `last`,改傳明確 PMID 清單