How to review, copy, and troubleshoot references
Use the References Sidebar, change one note's citation presentation, copy entries, and resolve reference errors.
Use this guide to inspect an active note's references and correct entries that ZotLit cannot resolve or format.
Review the references
Open the References Sidebar
Open the Markdown note you want to review. Run:
ZotLit: 打开参考文献The sidebar follows the active note. A formatted list uses the selected CSL style and bibliography order.
Find each citation occurrence
Select the chevron at the right of an entry. ZotLit moves the editor to that entry's next occurrence.
Select it again to cycle through later occurrences. The action returns to the first occurrence after the last one.
Open the related item
Hover the entry or focus it with the keyboard to reveal its row actions.
- 打开文献笔记 opens the note. ZotLit creates it first when the Zotero item has no Literature Note.
- 在 Zotero 中打开 selects the item in Zotero.
- 在 Zotero 文库中显示 reveals and flashes the paper in the Library View.
- 在 Zotero 中打开附件 opens its attachment. When several attachments exist, ZotLit opens a selection menu.
An attachment action appears only when the item has an attachment to open.
Inspect a citation from the editor
Under Settings > ZotLit > 引文 > 悬停, set 悬停行为 to 引用弹出框.
Hover a formatted citation. The popover shows each cited item's complete bibliography entry and the same Literature Note, Zotero, 在 Zotero 文库中显示, and attachment actions.
Use 需要按住修饰键 to control hover separately for 源码模式, 实时预览, and reading view.
Change one note's presentation
Open the note, then run:
ZotLit: 设置引文呈现方式You can also select 设置引文呈现方式 from the active note's More options menu.
- Select a 引用与参考文献样式 installed in Zotero, or keep the vault style.
- Enter a 文档语言, such as
en-US,de, orzh-CN. - Select 保存.
The style applies to this note's in-text citations, 参考文献 Sidebar, 引用弹出框, copied bibliography, built-in export, and native Pandoc runs. 文档语言 sets Pandoc lang for the complete exported document, not only its citations.
Select the reset button beside 文档语言. Its tooltip is 使用仓库的引用语言并删除文档语言. This removes lang from the note, so citation formatting uses the vault 引用语言.
Copy references
Copy the complete bibliography
Select 复制参考文献 in the 参考文献 Sidebar toolbar. ZotLit copies the formatted entries in bibliography order, without a heading.
The clipboard contains rich text and plain text. Plain-text entries have a blank line between them.
Copy one entry
Select the text of one entry in the sidebar. Use your operating system's normal copy shortcut.
Selecting the row's chevron navigates to citation occurrences. It does not copy the entry.
Fix a disabled Copy bibliography action
Hover the disabled action to see its current reason.
| Tooltip | What to do |
|---|---|
| 打开笔记后即可复制其参考文献 | Open the Markdown note whose bibliography you need. |
| 当前笔记没有可复制的参考文献 | Add a recognized citation to the active note. |
| 请等待参考文献排版完成 | Wait for the current formatting pass to finish. |
| 参考文献排版不可用 | Install or restore the Pandoc engine and an available style. |
| 参考文献排版失败 | Check the engine and selected style, then retry after the sidebar refreshes. |
| 请先修复参考文献错误，然后再复制 | Correct every Reference Error listed in the sidebar. |
The action also becomes temporarily unavailable when the active note, style, locale, or Zotero data changes. Wait for the new bibliography to finish formatting.
Fix Reference Errors
Each Reference Error stays tied to its exact source occurrence. Use the row's chevron to open that occurrence.
| Sidebar state | Cause | Recovery |
|---|---|---|
@key matches no item in your Zotero library. | No item in 文库范围 has that citation key. | Correct the key, add the matching library to the scope, or assign the key to the intended item. |
@key matches multiple items in your Zotero library. | Several in-scope items have the same citation key. | Give each item a distinct key, or narrow 文库范围 until the key is unique. |
This link has an invalid citation fragment. | A Literature Note link has a malformed #cite: fragment. | Correct the fragment. For a page locator, use #cite:locator=33. |
{linkpath} points to an item that is no longer in your Zotero library. | The Literature Note's zotero-key no longer resolves to an item. | Restore the Zotero item or correct the Literature Note identity. |
An ambiguous row lists every matching item with its library and item key. 打开文献笔记 stays unavailable until the citation key identifies one item.
Fix presentation errors
| Banner | Recovery |
|---|---|
| This note's citation and references style is unavailable | Correct the note's zotlit-csl, install that style in Zotero, or use the vault style. |
| This note's document language is invalid | Set lang to a language tag such as de-DE, or remove the property. |
| ZotLit could not format these references | Check the selected style and Pandoc 引擎 under Settings > ZotLit > 引文 > 参考文献. |
| The Pandoc engine is unavailable | Open the same settings page and repair or reinstall the engine. |
The sidebar shows a minimal list when formatted output is unavailable. Copy remains disabled until ZotLit produces a complete bibliography without Reference Errors.
See also
Last updated on