Zotero import template for the Zotero integration plugin for Obsidian. Screenshots and usage guide over in the Obsidian forum here: https://forum.obsidian.md/t/zotero-integration-import-templates/36310/105?u=feralflora

01 Zotero Integration import template and more!.md

• ZI-main.md
  • The main Zotero Integration template
• runImport.md
  • Template that enables updating literature notes at the click of a button, and much more.
• Meta bind button template
  • Template for in-note button that executes runImport.md

Meta bind button template.md

The Buttons plugin is likely to be deprecated, and the maintainer (@shabegom) is urging users to migrated to Meta Bind and it's implementation of buttons. See mProjectsCode/obsidian-meta-bind-plugin#199. Therefore, I've switched out the old "Buttons" button to a Meta bind button that does the same thing.

Here's how to make it functional:

If you had set up the old "Buttons" button, you can skip steps 2, 3 & 4.

1. If you haven't, install Meta Bind and Templater.
2. Make sure you have the "runImport" Templater template in your vault (also found under this gist).
3. In the runImport.md template, replace 'IMPORT_NAME' with the name you've given the Import format you want Zotero Integration to run, when importing your literature notes.

Warning

You need the name of the Import Format in Zotero Integration's settings, NOT the file name of your literature note template. See the example below.

For example, below here, the import name is "APA Literature Note", and that's what you should use.

4. Associate the runImport template with a hotkey / command in Templater's settings under "Template hotkeys".
5. Copy everything inside the "button" code block below (without the code block itself).
6. Paste the code into an editor, and replace the path on the last line with the path to runImport inside your vault.
7. Copy your newly edited button template, with the path corrected.
8. Open Meta bind's settings.
9. Find "Button templates" and press "Edit templates".
10. At the bottom of the popup, press the button that says "Add Template from Clipboard".
11. Then, remember to press save before you exit the "Edit templates" menu.

Button template

label: Update literature note
hidden: false
tooltip: "This will fetch new annotations from Zotero"
id: update-litnote
style: primary
actions:
  - type: command
    command: templater-obsidian:07 - Bins/Templates/Zotero Integration/runImport.md

Remember to replace path in the last line. The path starts at "07".

runImport.md

<%* // Get citekey from 'citekey' property, or alias starting with '@' or file name const citekey = tp.frontmatter?.citekey || tp.frontmatter.aliases?.find(alias => alias.startsWith('@')) || tp.file.title; // Get the library ID from the properties. Fall back to "My Library" (1), if the library ID is not accessible const libraryID = tp.frontmatter.libraryID || 1; // Run the import app.plugins.getPlugin('obsidian-zotero-desktop-connector').runImport('IMPORT NAME', citekey, libraryID); ; %>

ZI-main.md

{# version: 3.6 -#}

citekey: {{citekey}} aliases:

• "{%- if creators -%} {{creators[0].lastName or creators[0].name }} {%- if creators|length == 2 %} & {{creators[1].lastName or creators[1].name}}{% endif -%} {%- if creators|length > 2 %} et al.{% endif -%} {%- endif -%} {%- if date %} ({{date | format("YYYY")}}){% endif -%} {%- if shortTitle %} {{shortTitle | safe}} {%- else %} {{title | safe}} {%- endif -%}"{% if itemType == "bookSection" %} book-title: "{{bookTitle | replace('"',"'")}}"{% endif %} title: "{{title | replace('"',"'")}}" {%- set camelRegex = r/([a-z])([A-Z])/g %} {%- for type, creators in creators | groupby("creatorType") %} {% if creators.length > 1 %}{{type | replace(camelRegex, "$1 $2") | lower | trim}}s:{%- for creator in creators %}{% if creator.name %}
• {{creator.name}}{% else%}
• {{creator.firstName}} {{creator.lastName}} {% endif %}{%- endfor %} {% else -%} {{type | replace(camelRegex, "$1-$2") | lower | trim}}:{%- for creator in creators %}{% if creator.name %} "{{creator.name}}"{% else%} "{{creator.firstName}} {{creator.lastName}}"{% endif -%}{%- endfor -%}{% endif -%}{% endfor %} year: {% if date %}{{date | format("YYYY")}}{% endif %} item-type: {{itemType | replace(camelRegex, "$1 $2") | title | trim}} publisher: {% if publicationTitle %}"{{publicationTitle}}"{% else %}"{{publisher}}"{% endif %} {%- if notes.length > 0 -%} {%- set longShortCutoff = 20 -%} {%- set shortnotes = [] -%} {%- set longnotes = [] -%} {%- for note in notes -%} {%- if note.note | wordcount <= longShortCutoff -%} {%- set shortnotes = (shortnotes.push(note.note), shortnotes) -%} {%- else -%} {%- set longnotes = (longnotes.push(note), longnotes) -%} {%- endif -%}{%- endfor -%}{%- endif -%} {%- for comment in shortnotes %} {%- if comment and loop.first %} comments: {% endif -%}
• "{{comment|replace('"',"'")| replace("\n"," ")}}"{% endfor %} tags:{% for t in tags %}
• {{t.tag | replace(r/\s+/g, "-")}}{% endfor %}{% if DOI %} doi: https://doi.org/{{DOI}}{% endif %}{% if itemType == "book" %} ISBN: {{ISBN}}{% endif %} cssclasses:
• literature-note{% if attachments.length > 0 %}{% for attachment in attachments %}{% if loop.first %} attachments:{% endif %}
• {{attachment.path}}{% endfor %}{% endif %} libraryID: {{libraryID}}

---

BUTTON[update-litnote]

{% persist "notes" -%} {%- if isFirstImport %}

{# ==The following sections (Key takeaways and Processing) are not filled automatically. They are for for you to write into manually.== -#}

Key takeaways

{#- The following is a cursor placeholder for the Templater plugin. After importing the note, you can jump to each of these with an assigned hotkey like ctrl+J #}

• <% tp.file.cursor(1) %>

Processing

• Status:: new
• Connections:: <% tp.file.cursor(4) %>
• Projects::

{% endif %}{% endpersist %}

[!info]- Info 🔗 Zotero{% if DOI %} | DOI{% endif %}{% for attachment in attachments | filterby("path", "endswith", ".pdf") %} | [PDF-{{loop.index}}](file:///{{attachment.path | replace(" ", "%20")}}){%- endfor %}

{% if bibliography %}Bibliography: {{bibliography|replace("\n","" )}}{% endif %}

Authors:: {% for a in creators %} [[03 - Source notes/People/{{a.firstName}} {{a.lastName}}|{{a.firstName}} {{a.lastName}}]]{% if not loop.last %}, {% endif %}{% endfor %}

{% if tags %}Tags: {% for t in tags %}#{{t.tag | replace(r/\s+/g, "-")}}{% if not loop.last %}, {% endif %}{% endfor %}{% endif %}

Collections:: {% for collection in collections %}[[{{collection.name}}]]{% if not loop.last %}, {% endif %}{% endfor -%} {%- set readingSpeed = 220 %} {%- set wordsPerPage = 360 %} {%- if pages %} {%- set pageRegex = r/(\d+)-(\d+)/ %} {%- set splitPages = pageRegex.test(pages) %} {%- if splitPages %} {%- set pageMatch = pageRegex.exec(pages) %} {%- set firstPage = pageMatch[1] %} {%- set pageCount = pageMatch[2] - pageMatch[1] %} {%- else %} {%- set pageCount = pages %} {%- endif %} {%- elif numPages %} {%- set pageCount = numPages %} {%- else %} {%- set pageCount = 0 %} {% endif -%} {%- if firstPage %}

First-page:: {{firstPage}} {%- endif -%} {%- if pageCount > 0 -%} {%- set readingTime = ((pageCount* wordsPerPage)/readingSpeed)/60 %}

Page-count:: {{pageCount}}

Reading-time:: {% if readingTime < 1 %}{{(readingTime * 60) | round + " minutes"}}{% else %}{{readingTime | round(3) + " hours"}}{% endif %}{% endif %}

[!abstract]- {% if abstractNote %} {{abstractNote|replace("\n","\n>")|striptags(true)|replace("Objectives", "Objectives")|replace("Background", "Background")|replace("Methodology", "Methodology")|replace("Results","Results")|replace("Conclusion","Conclusion")}} {% endif %}

[!quote]- Citations

content: "@{{citekey}}" -file:@{{citekey}}

{%- set headingRegex = r/^#+/ -%} {%- set titleRegex = r/^#+./ -%} {%- set lineRegex = r/^.$/m %} {%- if longnotes.length > 0 -%} {%- for n in longnotes -%} {%- if n and loop.first %}

[!note]- Zotero notes ({{longnotes.length}})

Notes longer than {{longShortCutoff}} words. {%- endif %}

[!example]- Note {{loop.index}} |{%- if headingRegex.test(n.note) == true %}{{n.note | replace(n.note,titleRegex.exec(n.note))|replace(headingRegex,"")}}{% else %} {{lineRegex.exec(n.note | truncate(30))}} {% endif %} {{n.note | replace("\n", "\n>> ")| replace(titleRegex, "")}}{% if n.tags.length > 0 %}

Tags:{% for t in n.tags %} #{{t.tag}}{% if not loop.last %}, {% endif %}{% endfor %}{% endif -%}{%- if not loop.last %} {%- endif -%} {%- endfor -%}{%- endif %}

---

Reading notes

{% set colorValueMap = { "#2ea8e5": { "colorCategory": "Blue", "heading": "❓ Problem formulation", "symbol": "@" }, "#5fb236": { "colorCategory": "Green", "heading": "🎯 Key takeaways", "symbol": "$" }, "#ffd400": { "colorCategory": "Yellow", "heading": "💬 Evidence and arguments", "symbol": "&" }, "#f19837": { "colorCategory": "Orange", "heading": "✅ Actionable takeaways", "symbol": "?" }, "#a28ae5": { "colorCategory": "Purple", "heading": "🧩 Concepts and frameworks", "symbol": "~" }, "#e56eee": { "colorCategory": "Magenta", "heading": "🗺️ Context and connections", "symbol": "€" }, "#ff6666": { "colorCategory": "Red", "heading": "🚧 Digging and disclaimers", "symbol": "!" }, "#aaaaaa": { "colorCategory": "Gray", "heading": "📌 Statistics and info", "symbol": "%" } } -%}

{%- macro tagFormatter(annotation) -%} {% if annotation.tags -%} {%- for t in annotation.tags %} #{{ t.tag | replace(r/\s+/g, "-") }}{% if not loop.last %}, {% endif %}{%- endfor %} {%- endif %} {%- endmacro -%}

{% persist "annotations" %} {% set annotations = annotations | filterby("date", "dateafter", lastImportDate) -%} {% if annotations.length > 0 %} Imported on [[{{importDate | format("YYYY-MM-DD")}}]] at {{importDate | format("HH:mm")}}

{%- set grouped_annotations = annotations | groupby("color") -%} {%- for color, colorValue in colorValueMap -%} {%- if color in grouped_annotations -%} {%- set annotations = grouped_annotations[color] -%} {%- for annotation in annotations -%} {%- set citationLink = '[(p. ' ~ annotation.pageLabel ~ ')](' ~ annotation.desktopURI ~ ')' %} {%- set tagString = tagFormatter(annotation) %}

{%- if annotation and loop.first %}

{{colorValue.heading}} %% fold %%

{% endif -%}

{%- if annotation.imageRelativePath %}

[!cite]+ Image {{citationLink}} ![[{{annotation.imageRelativePath}}]]{% if annotation.tags %} {{tagString}}{% endif %}{%- if (annotation.comment or []).indexOf("todo ") !== -1 %}

• {{annotation.comment | replace("todo ", "")}}{%- elif annotation.comment %} {{annotation.comment}}{%- endif %} {% elif (annotation.comment or []).indexOf("todo ") !== -1 %}

• {{annotation.comment | replace("todo ", "")}}:{% if not annotation.annotatedText %} {{citationLink}}{% else %}
  • {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ")}} {{citationLink}}{{tagString}}{% endif -%} {% elif annotation.comment %}
• {{annotation.comment}}:{% if not annotation.annotatedText %} {{citationLink}}{% else %}
  • {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ") }} {{citationLink}}{{tagString}}{% endif -%} {%- elif annotation.annotatedText %}
• {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ") }} {{citationLink}}{{tagString}} {%- endif -%}{%- endfor %}{%- endif -%} {% endfor -%} {% endif %}

{% endpersist %}

@IndexLibrorumProhibitorum thanks for the appreciation. I enjoy sharing my work and helping others :)

And, as you mention, I'm not quite done yet as there still improvements left to do. I have some ideas on how to have persistence and still be able to group annotations without duplication of headings. One way would involved more persistent fields, one for each color. The other would involve doing the persistence ourselves using javascript in Templater. However, the complexity of this is quite high. So I'm still mulling it over.

@FeralFlora Gotcha, thanks for giving it some thought though.

To share a tiny tiny micro-contribution of my own: When reviewing papers, I create new notes for concepts that I expect will tie several papers together. An example would be 'Organ transplantation', which naturally takes quotes and info from different papers. Using the Zotero integration plugin it's quite easy to just cite the paper as one normally does, but I noticed that such a citation wouldn't be registered under the "citations" block on the paper's own page. This is because the citation just gets formatted without explicitly using the citekey, which is what that citations block searches for.

Using the citation output format of 'Template', however, lets you set your own format that does allow you to use the citekey, and create a clickable link to that page. The following has worked well for me so far:

([[{{citekey}}|{{ creators[0].lastName }} {% if date %}{{ date | format("YYYY") }}{% endif %}]])

@DaveSamuels1998 The runImport template only comes into play when you need to update your literature note with new Zotero changes. So there's no way for me to tell if it's working based on that screenshot.

But I can tell that you haven't enabled the List callouts plugin, because then the highlights would be colored as in Zotero. My literature note template is made to work with the List callouts plugin.

Hello, for the Meta Bind Button Templates, what would be the beginning of the path? Is it the name of my Vault or the folder that the runImport.md is in?
For example, the name of my Vault is Personal Notes. Would I put command: templater-obsidian:07 - Personal Notes/Templates/runImport.md or would I put command: templater-obsidian:07 - Templates/runImport.md?
I tried both and I couldn't get my button to show updates to my document.

@DaveSamuels1998 What you are specifying in the button template is actually a Templater command that happens to specify the path of the template it executes as part of its command name. So you can just look in the command palette to see how the path should be specified.

In my case, 07 - is actually part of the path. My top level folders are numbered to order them, so it's 07 - Bins. I doubt your templates reside in a folder with the exact same numbering as I use, so you need to remove that part.

As for your two examples, if "Personal notes" is the vault, you should start with "Templates". You just need the part of the path that's inside the vault. But again, just look in the command palette and you'll see the correct path / command name.

@FeralFlora thank you so much for explaining what those sections are and why it's so important to keep them. I appreciate it! Not much else to say, but I really wanted to thank you for sharing the code and being so responsive to all the questions. You've made a big difference in how I easily I'm able to do my research, thank you!

@FeralFlora, I just wanted to reach out to thank you for the detailed explanations and well considered questions that you have posted over various forums - your questions and answers have repeatedly popped up for the same reasons along my Zotero > Obsidian > Pandoc > Typst/Rstudio/Quatro journey whilst trying to understand how these systems could fit together and replace my Microsoft apps and systems (whilst also trying to avoid the potential need to learn LaTex). Fittingly, this template served as the final piece joining the results of my efforts on each end together... and today being the final day I had given myself. Now I'm off to create some unpleasant beautiful documents.

Could you kindly explain how switch your highlight output (annotation) vs your comments in the template. I noted your post suggesting this (string below) but which lines of the code need to be swapped? I often put sources in my comments and they're numbered so its messing up the colored highlighting. Thanks!

{%- for annotation in annotations -%}
{%- if annotation.imageRelativePath %}
![[{{annotation.imageRelativePath}}]]
{%- endif %}
{%- if annotation.comment %}

• =={{annotation.annotatedText | nl2br}}== (p. {{annotation.pageLabel}}) {% if annotation.hashTags %}{{annotation.hashTags}}
  • {{annotation.comment|replace("todo ","[ ] ")}}{% endif %}
    {%- elif annotation.annotatedText %}
• =={{annotation.annotatedText | nl2br}}== (p. {{annotation.pageLabel}}) {% if annotation.hashTags %}{{annotation.hashTags}}{% endif %}

{%- endif -%}{%- endfor %}

{% endfor -%}
{% endif %}
{% endpersist %}

Hey, has anybody an idea why not all of my colors are, well colored?
Here is how it looks when rendered:

Here is the raw source code of the template:

citekey: {{citekey}}
aliases:

• "{%- if creators -%}
  {{creators[0].lastName or creators[0].name }}
  {%- if creators|length == 2 %} & {{creators[1].lastName or creators[1].name}}{% endif -%}
  {%- if creators|length > 2 %} et al.{% endif -%}
  {%- endif -%}
  {%- if date %} ({{date | format("YYYY")}}){% endif -%}
  {%- if shortTitle %} {{shortTitle | safe}} {%- else %} {{title | safe}} {%- endif -%}"{% if itemType == "bookSection" %}
  book-title: "{{bookTitle | replace('"',"'")}}"{% endif %}
  title: "{{title | replace('"',"'")}}"
  {%- set camelRegex = r/([a-z])([A-Z])/g %}
  {%- for type, creators in creators | groupby("creatorType") %}
  {% if creators.length > 1 %}{{type | replace(camelRegex, "$1 $2") | lower | trim}}s:{%- for creator in creators %}{% if creator.name %}
• {{creator.name}}{% else%}
• {{creator.firstName}} {{creator.lastName}} {% endif %}{%- endfor %} {% else -%}
  {{type | replace(camelRegex, "$1-$2") | lower | trim}}:{%- for creator in creators %}{% if creator.name %} "{{creator.name}}"{% else%} "{{creator.firstName}} {{creator.lastName}}"{% endif -%}{%- endfor -%}{% endif -%}{% endfor %}
  year: {% if date %}{{date | format("YYYY")}}{% endif %}
  item-type: {{itemType | replace(camelRegex, "$1 $2") | title | trim}}
  publisher: {% if publicationTitle %}"{{publicationTitle}}"{% else %}"{{publisher}}"{% endif %}
  {%- if notes.length > 0 -%}
  {%- set longShortCutoff = 20 -%}
  {%- set shortnotes = [] -%}
  {%- set longnotes = [] -%}
  {%- for note in notes -%}
  {%- if note.note | wordcount <= longShortCutoff -%}
  {%- set shortnotes = (shortnotes.push(note.note), shortnotes) -%}
  {%- else -%}
  {%- set longnotes = (longnotes.push(note), longnotes) -%}
  {%- endif -%}{%- endfor -%}{%- endif -%}
  {%- for comment in shortnotes %}
  {%- if comment and loop.first %}
  comments:
  {% endif -%}
• "{{comment|replace('"',"'")| replace("\n"," ")}}"{% endfor %}
  tags:{% for t in tags %}
• {{t.tag | replace(r/\s+/g, "-")}}{% endfor %}{% if DOI %}
  doi: https://doi.org/{{DOI}}{% endif %}{% if itemType == "book" %}
  ISBN: {{ISBN}}{% endif %}
  cssclasses:
• literature-note{% if attachments.length > 0 %}{% for attachment in attachments %}{% if loop.first %}
  attachments:{% endif %}
• {{attachment.path}}{% endfor %}{% endif %}
  libraryID: {{libraryID}}

---

{% persist "notes" -%}
{%- if isFirstImport %}

{# ==The following sections (Key takeaways and Processing) are not filled automatically. They are for for you to write into manually.== -#}

Key takeaways

{#- The following is a cursor placeholder for the Templater plugin. After importing the note, you can jump to each of these with an assigned hotkey like ctrl+J #}

{% endif %}{% endpersist %}

[!info]- Info 🔗 Zotero{% if DOI %} | DOI{% endif %}{% for attachment in attachments | filterby("path", "endswith", ".pdf") %} | [PDF-{{loop.index}}](file:///{{attachment.path | replace(" ", "%20")}}){%- endfor %}

{% if bibliography %}Bibliography: {{bibliography|replace("\n","" )}}{% endif %}

Authors:: {% for a in creators %} [[2_Literature/People/{{a.firstName}} {{a.lastName}}|{{a.firstName}} {{a.lastName}}]]{% if not loop.last %}, {% endif %}{% endfor %}

{% if tags %}Tags: {% for t in tags %}#{{t.tag | replace(r/\s+/g, "-")}}{% if not loop.last %}, {% endif %}{% endfor %}{% endif %}

Collections:: {% for collection in collections %}[[{{collection.name}}]]{% if not loop.last %}, {% endif %}{% endfor -%}
{%- set readingSpeed = 220 %}
{%- set wordsPerPage = 360 %}
{%- if pages %}
{%- set pageRegex = r/(\d+)-(\d+)/ %}
{%- set splitPages = pageRegex.test(pages) %}
{%- if splitPages %}
{%- set pageMatch = pageRegex.exec(pages) %}
{%- set firstPage = pageMatch[1] %}
{%- set pageCount = pageMatch[2] - pageMatch[1] %}
{%- else %}
{%- set pageCount = pages %}
{%- endif %}
{%- elif numPages %}
{%- set pageCount = numPages %}
{%- else %}
{%- set pageCount = 0 %}
{% endif -%}
{%- if firstPage %}

First-page:: {{firstPage}}
{%- endif -%}
{%- if pageCount > 0 -%}
{%- set readingTime = ((pageCount* wordsPerPage)/readingSpeed)/60 %}

Page-count:: {{pageCount}}

Reading-time:: {% if readingTime < 1 %}{{(readingTime * 60) | round + " minutes"}}{% else %}{{readingTime | round(3) + " hours"}}{% endif %}{% endif %}

[!abstract]-
{% if abstractNote %}
{{abstractNote|replace("\n","\n>")|striptags(true)|replace("Objectives", "Objectives")|replace("Background", "Background")|replace("Methodology", "Methodology")|replace("Results","Results")|replace("Conclusion","Conclusion")}}
{% endif %}

[!quote]- Citations

content: "@{{citekey}}" -file:@{{citekey}}

{%- set headingRegex = r/^#+/ -%}
{%- set titleRegex = r/^#+./ -%}
{%- set lineRegex = r/^.$/m %}
{%- if longnotes.length > 0 -%}
{%- for n in longnotes -%}
{%- if n and loop.first %}

[!note]- Zotero notes ({{longnotes.length}})

Notes longer than {{longShortCutoff}} words.
{%- endif %}

[!example]- Note {{loop.index}} |{%- if headingRegex.test(n.note) == true %}{{n.note | replace(n.note,titleRegex.exec(n.note))|replace(headingRegex,"")}}{% else %} {{lineRegex.exec(n.note | truncate(30))}}
{% endif %}
{{n.note | replace("\n", "\n>> ")| replace(titleRegex, "")}}{% if n.tags.length > 0 %}

Tags:{% for t in n.tags %} #{{t.tag}}{% if not loop.last %}, {% endif %}{% endfor %}{% endif -%}{%- if not loop.last %}
{%- endif -%}
{%- endfor -%}{%- endif %}

---

Reading notes

{% set colorValueMap = {
"#2ea8e5": {
"colorCategory": "Blue",
"heading": "❓ Problem formulation",
"symbol": "?"
},
"#5fb236": {
"colorCategory": "Green",
"heading": "🎯 Key takeaways",
"symbol": "$"
},
"#ffd400": {
"colorCategory": "Yellow",
"heading": "💬 Evidence and arguments",
"symbol": "&"
},
"#f19837": {
"colorCategory": "Orange",
"heading": "✅ Actionable takeaways",
"symbol": "!"
},
"#a28ae5": {
"colorCategory": "Purple",
"heading": "🧩 Concepts and frameworks",
"symbol": "~"
},
"#e56eee": {
"colorCategory": "Magenta",
"heading": "🗺️ Context and connections",
"symbol": "€"
},
"#ff6666": {
"colorCategory": "Red",
"heading": "🚧 Digging and disclaimers",
"symbol": "£"
},
"#aaaaaa": {
"colorCategory": "Gray",
"heading": "📌 Statistics and info",
"symbol": "%"
}
} -%}

{%- macro tagFormatter(annotation) -%}
{% if annotation.tags -%}
{%- for t in annotation.tags %} #{{ t.tag | replace(r/\s+/g, "-") }}{% if not loop.last %}, {% endif %}{%- endfor %}
{%- endif %}
{%- endmacro -%}

{% persist "annotations" %}
{% set annotations = annotations | filterby("date", "dateafter", lastImportDate) -%}
{% if annotations.length > 0 %}
Imported on [[{{importDate | format("YYYY-MM-DD")}}]] at {{importDate | format("HH:mm")}}

{%- set grouped_annotations = annotations | groupby("color") -%}
{%- for color, colorValue in colorValueMap -%}
{%- if color in grouped_annotations -%}
{%- set annotations = grouped_annotations[color] -%}
{%- for annotation in annotations -%}
{%- set citationLink = '[(p. ' ~ annotation.pageLabel ~ ')](' ~ annotation.desktopURI ~ ')' %}
{%- set tagString = tagFormatter(annotation) %}

{%- if annotation and loop.first %}

{{colorValue.heading}} %% fold %%

{% endif -%}

{%- if annotation.imageRelativePath %}

[!cite]+ Image {{citationLink}}
![[{{annotation.imageRelativePath}}]]{% if annotation.tags %}
{{tagString}}{% endif %}{%- if (annotation.comment or []).indexOf("todo ") !== -1 %}

• {{annotation.comment | replace("todo ", "")}}{%- elif annotation.comment %}
  {{annotation.comment}}{%- endif %}
  {% elif (annotation.comment or []).indexOf("todo ") !== -1 %}

• {{annotation.comment | replace("todo ", "")}}:{% if not annotation.annotatedText %} {{citationLink}}{% else %}
  • {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ")}} {{citationLink}}{{tagString}}{% endif -%}
    {% elif annotation.comment %}
• {{annotation.comment}}:{% if not annotation.annotatedText %} {{citationLink}}{% else %}
  • {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ") }} {{citationLink}}{{tagString}}{% endif -%}
    {%- elif annotation.annotatedText %}
• {{colorValue.symbol}} {{annotation.annotatedText | replace(r/\s+/g, " ") }} {{citationLink}}{{tagString}}
  {%- endif -%}{%- endfor %}{%- endif -%}
  {% endfor -%}
  {% endif %}

{% endpersist %}

Hey @Bulgy404,

The reason why those annotations have no color is because the symbols at the start don't correspond to the defaults of the List Callouts plugin, which is what handles the coloring of the annotations in Obsidian. The List Callouts plugin comes with 7 preconfigured symbols that will be rendered as highlighted list callouts:

Color	List Callouts' defaults	My setup
Blue	@	?
Green	$	$
Yellow	&	&
Orange	?	!
Purple	~	~
Magenta	no default	€
Red	!	£
Gray	%	%

Zotero includes an eigth color: Magenta. Two of your annotations are magenta, so this is why they are lacking colors in Obsidian. I'll explain the issue with the red color below.

Magenta

As mentioned in my setup guide over in the Obsidian forum, I recommend setting up a symbol -> color configuration for magenta in the List Callouts plugin's settings. The template adds the "€" symbol for magenta, by default, so the easiest thing is to setup a color for that symbol in the List Callout settings, but feel free to choose any symbol that works for you. Just make sure that the List callout settings and the template use the same symbols for the same colors.

Red

The other case where you're missing colors is Red. The reason for this is an oversight on my part, as it reflects my personal setup. Originally, I made the template so that all seven of the default colors worked as expected out of the box, with the Zotero colors mapped to the List Callout defaults. But since then, I've switched to using ! for orange (which means "Actionable takeaways" in my annotation system) rather than for red, and then I needed a new symbol for red. I chose £ for Red, but this is not part of the List Callout defaults.

This is also the reason why your orange highlights are shown as red in Obsidian.

I will change it again so that the template shared here corresponds to the List Callout defaults, so that colors will match with Zotero as expect. It will still be necessary to add a configuration for magenta, though.

The simplest solutions

1. Fix Magenta: Add a List Callout configuration for the € symbol and choose magenta as the color
2. Fix Orange: Change the template so that the symbol for red is !, and the symbol for orange is ?

Or, customize the symbols you use in whatever way makes sense to you (maybe ? for whichever color you use for questions?). Just make sure that the symbol assigned in the template corresponds to what you configure in the List Callout plugin's settings.

@Bulgy404 I've now updated the gist so that the symbol-to-color mappings are again aligned with the List Callout defaults. This means that going forward, people only need to add the configuration for magenta. All the other colors should now work as expected out-of-the-box again. The template still uses € for magenta.

I still recommend that people change the List Callout defaults to suit their needs, and to make the usage of the symbols more intuitively aligned with the meaning of the annotation color. Just make that the symbol-to-color mappings are the same in the List Callouts configuration and the template.

@Shade1698 & @douglasbreaks Sorry for taking so long in getting back to you. Just wanted to say thank you for reaching out, I really appreciate it, and I'm very glad to hear that my work and help has been so valuable for you. Good luck with everything, and don't hesitate to reach out again, if you need anything!