harang-contacts documentation

An Obsidian plugin that lets you reference contacts from a CardDAV address book directly from your notes.

Type a dedicated inline syntax and pick a contact from your CardDAV server; it is rendered as a compact chip (name, and email if the contact has one) right in the note, and clicking the chip opens a small card with the contact’s full details. The plugin is read-only — it never creates, edits, or deletes anything on your CardDAV server.

Contents

• Prerequisites
  • 1. A reachable CardDAV server
  • 2. Obsidian 1.13.4 or later
• Installation
  • Method 1 — Community Plugins browser (recommended)
  • Method 2 — Manual install of pre-built files
  • Method 3 — Clone the Git repository and build from source
• Usage
  • Adding a CardDAV server profile
  • Referencing a contact in a note
  • Viewing contact details
  • Refreshing the address book cache
• Architecture
  • Source layout
  • Data flow
  • Reference syntax
  • No runtime dependencies
• Troubleshooting & FAQ
  • “Connection failed” when testing a profile
  • A chip looks faded with a dashed border (“unresolved”)
  • The plugin doesn’t appear after installing
  • The plugin doesn’t update after git pull

Indices and tables

• Index

• Search Page