Research Connected

by Junwei Bai
5
4
3
2
1
Score: 28/100

Description

Obsidian literature maps with citation evidence, research projects, reading workflows, and linked notes, powered by OpenAlex.

Reviews

No reviews yet.

Stats

1
stars
959
downloads
1
forks
44
days
7
days
24
days
4
total PRs
1
open PRs
0
closed PRs
3
merged PRs
9
total issues
9
open issues
0
closed issues
162
commits

README file from

Github

See the research neighborhood

Light original · Dark original

All screenshots: interface preview captured October 29, 2026 at 3200 × 2000 (2×), outside the Obsidian window. Sample: “Deep learning” (2015); live public metadata may change.

Select a node or an edge to inspect shared references, co-citations, and direct citation evidence. The side panel’s bottom tabs include Frequently cited references (cited by at least two visible papers) and Works citing this graph (cites at least two visible papers); neither label implies publication order or intellectual influence.

Three steps, one reading workflow

  • Discover related research. Enter a title, DOI, or OpenAlex ID and build a sampled similarity map. Switch among Planar, Year, and Radial layouts.
  • Inspect each connection. Read the references and citation evidence behind a relationship. The plugin may retrieve additional abstracts and reference data from OpenAlex, Semantic Scholar, or Crossref; OpenCitations can add citation evidence. A failed request does not prove that a source has no record.
  • Organize your reading. Save paper adds an individual paper to the project’s saved list; Save project saves the project. Set a paper’s Reading status, exclude noise, write literature notes, embed the graph, or export BibTeX, YAML, and Markdown.

Quick start

  1. Install and enable. In Obsidian, open Settings → Community plugins → Browse, search for Research Connected, then install and enable it.
  2. Build your first map. Run Open Research Connected from the command palette. Paste the DOI below, or enter a paper title to choose the Seed paper, then select Build.
  3. Inspect a connection. Select a paper or an edge to see why it is on the map. Use Save project to save the project; use Save paper to keep an individual paper in its saved list.
10.1038/nature14539

This example is “Deep learning” by LeCun, Bengio, and Hinton (2015). Results can change as the source databases update.

Manual installation. Download main.js, manifest.json, and styles.css from the latest release, place them in <vault>/.obsidian/plugins/research-connected/, reload Obsidian, and enable the plugin.

Explore research over time

Light original · Dark original

Choose the Year layout. The year band below the map narrows the visible papers by publication year.

Keep the graph beside your notes

Light original · Dark original

Add this block to a note. It renders in Reading view and Live Preview.

```research-connected
doi: 10.1038/nature14539
height: 520
layout: temporal
```

Select a paper and choose Export → Write to note to create a literature note. The plugin recognizes existing notes by DOI or OpenAlex ID. Reading status can be synchronized with linked notes; conflicting values require review. Set the folder, filename, body template, and DOI property in settings.

Embed options, note properties (YAML frontmatter), sampling, and algorithms are in the user guide. The older connected-papers embed name still works.

Behavior notes

  • Reading status is shared across projects and confirmed version groups; saved papers and exclusions stay project-specific. Conflicts and external note edits require explicit resolution, retry, or sync opt-out.
  • Version groups use source-confirmed relationships or manual decisions, never title-only guesses. Exports retain version provenance.
  • Candidate diagnosis and citation paths distinguish missing evidence from measured zero. MMR balances relevance and diversity; semantic signals supplement structural evidence.
  • Node size uses log-scaled citation counts. The high-citation indicator is a heuristic, not an authoritative assessment. Animation respects reduced-motion preferences.

Before you start

  • Desktop. Obsidian 1.14.4 or later. Mobile support awaits device testing.
  • Network. Building a map queries external scholarly services. Projects and reading status stay in your vault; see the privacy note below for what is sent.
  • Service key. An OpenAlex API key is optional and recommended. Create one in OpenAlex settings. Configuration is in the guide.
  • Notes. Note properties (YAML frontmatter) are read to recognize literature notes. A note file changes only when you write one or change its reading status.
  • AI. The research narrative is off by default. Exploring the map does not require a language model.
  • Interface language. Simplified Chinese for Chinese locales, English otherwise.

Network use and privacy

  • OpenAlex receives the DOI, OpenAlex ID, or search text you enter, and your API key and optional contact email if set. The email is also sent to Crossref as contact information; it does not guarantee a higher request limit.
  • Semantic Scholar, Crossref, and OpenCitations receive paper identifiers. A key or token is sent only to the service it belongs to.
  • Your language-model endpoint receives the selected papers and their citation evidence only after you enable the research narrative and press Generate. Abstracts are included only if that option is on.

To match existing literature notes, the plugin lists Markdown paths and reads their cached note properties. Copy and export write to the system clipboard; the plugin does not read it. Writing a literature note or changing its reading status updates that vault file.

Projects, reading statuses, saved papers, and service credentials are stored in this vault's plugin data.json. Credentials are not encrypted; vault sync or backup tools may copy this file. The plugin sends no telemetry and reads note properties (YAML frontmatter) to recognize literature notes.

Limitations

  • The map is a sample, not a complete citation index; consult the user guide for sampling details.
  • Semantic similarity can use compatible vectors as well as local text and topic signals; it is exploratory, not a measure of research quality. Verify important claims against the original papers.
  • OpenAlex has known gaps: missing abstracts, incomplete reference lists, and author disambiguation errors. The user guide lists each gap and what the plugin does about it.

Help and feedback

  • Something is not working. Report a bug. Include the plugin and Obsidian versions, your system, the steps, and the expected and actual results. A public DOI or OpenAlex ID helps with paper-data problems.
  • A research workflow needs to change. Request a feature. Describe the task, what gets in the way, and the result you need.
  • Setup help. Read the user guide and check existing issues.

English or Chinese is welcome. Submitting requires a GitHub account, and reports are public. Do not include API keys, private notes, unpublished research, a full vault, or data.json. A feature request does not promise implementation or a delivery date.

Updates and license

Changes are in the release notes. Planned work is on the roadmap. Code and documentation contributions follow the contributing guide.

AGPL-3.0. Research Connected is an independent project and is not affiliated with Connected Papers.