How Risorgi works

Risorgi is a place to build and explore interconnected knowledge. Every post can become a node in a graph, and links between posts show how ideas relate to each other.

Authors write in Markdown, connect their own posts, and link to posts from other people. Readers can browse the map, open individual articles, upvote what resonates, and bookmark posts to revisit later.

Signed-in users also get a private archive. It is a personal canvas where you can collect posts, draw your own connections, and keep bookmarks separate from what you publish publicly.

Reading without an account

You do not need an account to read public posts or explore the map. Open any post at a URL like /@username/post-slug, or start from the global map.

Creating an account

To publish, upvote, bookmark, or build your archive, create a free account. After signing in, your public profile lives at /@yourname and shows your published graph.

Main places to know

• Map (/explore): explore the shared graph of all public posts and connections.
• Publish (/publish): write and manage your posts (requires sign-in).
• Archive (/archive): your private graph and bookmarks (requires sign-in).
• Settings (/settings): update your display name, password, and avatar. Username and email are read-only; contact support to change them.

Open the publish panel to create and edit posts. Each post has a title at the top and a visual writing area below. The title drives your post's slug on your profile.

Publishing

When you save a post, it is published to your profile at /@yourname/post-slug. The slug is generated from the title. Posts are public and appear in search and on the map.

Editor features

• A visual editor with a formatting toolbar for headings, bold, italic, links, quotes, and highlights. What you see while writing is what readers see when the post is published.
• Image uploads: drag an image into the editor or use the image button. Images are stored with your post.
• A Connections panel to view and add graph lines between posts on your public profile.

Graph connections are how posts link on Risorgi. You add them manually from the editor or graph, not by typing special syntax in the body.

Connect from the editor

While editing one of your posts, open the Connections panel and search for another post. The edge appears on your public profile graph and the global map. The source post must be yours.

Connect from the graph

On your profile graph or in your archive, select a post and use the Connections search in the preview panel, or use link mode on the canvas to click two nodes.

Legacy [[wiki links]] in body text

Risorgi no longer treats [[double brackets]] as special links. If older posts still contain that syntax, it shows as plain text. Use the Connections panel to draw graph edges instead.

The global map

The map shows the shared network of all public posts and all connections between them. Pan and zoom to explore, click a node to focus it, and use search to highlight matching posts. Labels fade in as you zoom closer, so dense areas stay readable.

Profile graphs

Every author has a public graph at /@username. It includes their own posts, manual connections they added from the editor or graph, and posts from other people they connected to (borrowed nodes). Open a specific post on someone's graph with /@username?post=post-slug.

Reading a post

Individual posts live at /@username/post-slug. From there you can read the full article, see the author, upvote, bookmark, and jump to the post on the graph.

Graph navigation tips

• On desktop, scroll to zoom and drag to pan. On trackpads and touch devices, pinch to zoom and use two-finger drag to pan.
• Search highlights matching posts and dims unrelated nodes.
• Selecting a post shows its connections in the sidebar and centers the view on that node.
• Highly connected posts reveal their titles earlier when zooming in, so hubs are easier to spot.

Your archive is private. It is a separate workspace from your public profile, only you can see it.

Graph tab

The Graph tab shows posts you have placed on your personal canvas and the connections you drew between them. Posts do not appear here automatically from your published writing, add them with the + button, or pin a saved post from the Bookmarks tab. Connections in the archive are manual only.

To connect two posts on the canvas, turn on link mode (the chain icon) and click two nodes, or select a post and use the Connections panel to search for another post.

Bookmarks tab

The Bookmarks tab lists posts you have saved. Use + to search and bookmark a post, pin a bookmarked post onto your graph canvas, or remove bookmarks you no longer need. Open the tab directly with /archive?tab=bookmarks.

Archive vs. public profile

• Public profile (/@you): what others see: your published posts, manual connections, and borrowed nodes from posts you connected to.
• Archive: only visible to you: a curated canvas of posts you added or pinned, with private manual connections and saved bookmarks.

Upvotes

Signed-in readers can upvote posts by other people. Upvote counts appear on posts and on graph nodes. You cannot upvote your own posts. Reading stays open to everyone without an account.

Bookmarks

Bookmark someone else's post from its article page or from the graph. Bookmarked posts show up in your archive under the Bookmarks tab. From there you can pin them onto your personal graph or keep them as a reading list. You cannot bookmark your own posts.

Bookmarks are private, other users cannot see what you have saved.

All graph edges are manual. Risorgi keeps public profile connections separate from your private archive.

Public profile (editor)

While editing one of your posts, open the Connections panel and search for another post to link. These connections appear on your public profile graph and the global map. The source post must be yours.

Archive (graph view)

In your archive, connect posts with link mode on the canvas (click two nodes), or select a post and use the Connections search in the preview panel. Archive connections are private and do not affect your public profile.

Removing connections

• Public manual connections: Remove them from the Connections panel in the editor.
• Archive connections: Remove them from the archive preview panel, or use link mode to click two already-connected nodes and unlink them.

Risorgi uses Markdown with a few Obsidian-style extras. These work in the editor and on published posts.

URLs written as plain text (like https://example.com) are automatically turned into clickable links. Blank lines create paragraph breaks; the editor preserves the vertical rhythm you see while writing.

The post title is edited separately at the top of the editor, it is not the same as a # Heading line in the body.

Post limit

Each account can create up to 100 posts. If you hit the limit, you will see 100 posts limit reached. Contact support if you need more.

Graph limits

Your public profile graph and your archive graph each have their own limit of 100 posts as nodes. The public graph counts your posts plus any other posts linked or connected there; the archive counts posts you have added or pinned to your private canvas. If you hit either limit, you will see 100 posts limit reached. Contact support if you need more. Contact hey@risorgi.com if you need more capacity.

Pricing

Risorgi is free for everyone today. Paid features for power users may come later, but the core experience (reading, writing, linking, and exploring) will stay accessible.

If something is unclear or not working as expected, reach out at hey@risorgi.com.

You can also review the homepage FAQ for quick answers to common questions.