How can I customize the Readwise to RemNote Export?

One of the most powerful features of the Readwise to RemNote export integration is the ability to customize the formatting of how your highlight data is imported into RemNote. You can customize a variety of elements including:

  • Page title
  • Metadata (such as author, URL, category, title, cover image)
  • Highlight header (inserted whenever new highlights are added)
  • Sync notifications (a new entry in RemNote each time the Readwise plugin runs)

To begin customizing your export, head to the RemNote Export page from your Readwise Dashboard and toggle on "Use custom formatting". 

At a high level, each component of the export has a "template" using the Jinja2 templating language. As you tweak the template within Readwise, you'll see a live preview of what your notes would look like in Obsidian. 

The explanations below should illustrate how customization works, and give some useful examples.


Page Title

By default, Readwise will use the title of each document with the suffix (highlights) in the default template and will use the RemNote tagging scheme to tag the page with its category in Readwise (e.g., books will be tagged #books). If the document has a document tag in Readwise, those will also be added via the Page Title.

{{title}} (highlights) ##{{category}} {% if document_tags %}{% for tag in document_tags %}#[[{{tag}}]] {% endfor %}{% endif %}

Notice the {{title}} variable. As your highlights are exported to RemNote, Readwise will replace the {{title}} variable with the document's actual title.

Let's say you wanted the title exclude the word Highlights in parentheses. All you would have to do is delete the text " (Highlights)" from the template above as follows:

{{title}} ##{{category}} {% if document_tags %}{% for tag in document_tags %}#[[{{tag}}]] {% endfor %}{% endif %}

You can customize this much more using inline-if statements, Jinja2 filters, and much more. The templating language is quite powerful!


Metadata

One of the nicest aspects of the Readwise integration is that each document can be enhanced with additional metadata such as author name, document URL, document tags, category, full title, cover image, and more.

The default template below will insert the cover image, if there is one, followed by author name, full title, and URL, if any.

{% if image_url %}{{image_url}}{% endif %}
Author: [[{{author}}]]
Full Title: {{full_title}}
{% if url %}URL: {{url}}{% endif %}

Again, this templating language is quite powerful! You go much deeper with the customization using inline-if statements, Jinja2 filters, and more.


Highlight Header

Another component of the template is the header text that appears above each set of synced highlights. The first time a document is exported to RemNote, the Highlight section will be delineated by a parent bullet with any new highlights indented beneath.

{% if is_new_page %}
Highlights first synced by [[Readwise]] [[{{date}}]]
{% elif has_new_highlights %}
New highlights added [[{{date}}]] at {{time}}
{% endif %}

A common use case in tools for thought such as RemNote, Roam Research, and Obsidian is to backlink the date in this header to your Daily Notes page. This occurs by default in the RemNote


Sync Notifications

Every time Readwise syncs new highlights you've made into your RemNote account, it appends a little message into your daily notes page in RemNote, notifying you of the new. This links to your daily note as well, so that you can see all of the highlights you made in one day. Here's the default template:

On [[{{date}}]] at {{time}} Readwise synced {{num_highlights}} highlight{{num_highlights|pluralize}} from {{num_books}} book{{num_books|pluralize}}.

If you don't want these sync notifications at all, you can delete the entire template for your sync notifications.