What's new

NewPublishing: Roam Publish 0.3.0 can change a page's settings from Roam: where it's listed, its byline, view count and Download PDF, in its graph and in each of its collections, and take it out of a collection. Access and passwords are still changed here.

NewPublishing: Roam Publish 0.3.0 can change a collection's settings from Roam for its owner: name, description, byline, view count, Download PDF, Discover, search and RSS.

NewDashboard: Roam Publish 0.3.0 has a dashboard in Roam with your views, upvotes, reader countries, most read pages and collections. roam.pub now keeps each page's view count per day for 90 days, so it can show views by day from today on.

NewPublishing: Roam Publish 0.2.0 asks where to publish something new: your graph, your graph encrypted, or one of your collections. It starts on your graph's New pages go to setting, and a collection picked is the only place the page goes.

NewPublished pages: Open pages show a Public or Discover label after their title, next to the Unlisted, Password and Members only labels. Turn it off in a graph's or collection's Settings → Display with "Show Public and Discover labels".

NewPublishing: Publish with encryption. From Roam Publish 0.2.0, a page that isn't published yet can be published straight to your graph as a Password page, end-to-end encrypted with your graph password, whatever new pages usually start as. If your graph has no password that can encrypt yet, nothing is published and the extension says how to set one.

NewPublished pages: Download a page as a PDF. Turn on PDF download in a graph's or collection's Settings, or for one page in Manage → Display, and readers get a Download PDF button. The PDF is laid out for paper, with the title, author, dates and tags at the top and the page's link and page numbers at the bottom. Readers choose whether folded blocks print open or as shown. You pick the paper, font, text size and what's included; readers can change these for their own copy unless you turn on Enforce this style. Password and Members pages say the copy isn't protected.

NewSite: Links to roam.pub's own pages (the front page, Discover, profiles, What's new) show a preview card with the Roam Publish logo in chat apps and social posts, instead of no image.

NewDashboard: Pin a link you've shared. In Manage, open a place and click Pin link…, then paste where you've shared it (a post, a doc, a site). While it's pinned, roam.pub won't unpublish the page, take it out of that graph or collection, move it to Password or Members, change its password, or delete the graph or collection, whether you try on the website or from Roam, and the message says where it's shared. Republishing and switching between Discover, Public and Unlisted still work. Front pages and collection pages can be pinned from their settings.

NewSecurity: An encrypted page's title is encrypted too. roam.pub only knows it as "Encrypted page" (or "Encrypted block"), in its link, lists, emails and previews; readers' browsers that have the password show the real title, on the page and on its graph's or collection's front page. From extension 0.2.0 the title is encrypted in Roam, so roam.pub never sees it. Pages encrypted before this keep a readable title until they're next published from Roam or encrypted again. Links on other pages can't lead to a page whose title is encrypted.

NewSecurity: Password pages can be encrypted in Roam before they're published, so roam.pub never sees their text, not even while publishing. This needs extension 0.2.0; earlier versions keep publishing as before.

NewSecurity: Encryption versions. An encrypted page's badge says End-to-end encrypted (v2, encrypted in Roam) or Encrypted (v1, encrypted by roam.pub when it was published), with the code that did it, and so does its Manage dialog. Encryption versions explains each one; a v1 page becomes v2 when it's republished from extension 0.2.0 or newer.

NewSite: Upcoming changes lists changes that will need you to do something, before they happen: what changes, what to do, and how many extensions are ready. Signed in, it shows which of your graphs' extensions need an update. Find it from What's new.

NewPublishing: The Roam extension knows when it's too old for roam.pub. From extension 0.2.0, it asks you to update in Roam Depot when roam.pub has changed in a way it no longer works with, instead of failing.

NewSecurity: Add encrypted pages to collections without typing their password. From the Roam extension they open there right away. Added on roam.pub, they open once you republish them from Roam, or right away if you unlocked the page in your browser first.

NewPublished pages: Fold the whole page from its own thread line. A line now runs beside the page's top-level blocks, like the one under any block with children: click it to fold them all, and again to open them.

NewPublished pages: Hide the "On this page" outline. Click the button beside it to tuck it away; it stays hidden on every page until you bring it back.

NewPublished pages: Mermaid diagrams are drawn. A {{mermaid}} block, or a code block set to Mermaid, now shows the diagram instead of "Diagram not shown", with a button to see its source.

NewPublished pages: Copy code in one click. Every code block has a copy button, and its header names the language. Click inline code to copy it.

NewPublished pages: Zoom into any block, like in Roam. Click a block's bullet to see just that block and what's under it, with a trail above it to step back out. The address includes the block, so you can share a link to it.

NewPublished pages: Blocks collapsed in Roam can start collapsed on the published page, when the page is published that way from the extension. Readers can open and close them as usual.

NewPublished pages: Fold blocks away on published pages, like in Roam. Hover a block that has children and click the arrow beside its bullet to collapse it; a folded block's bullet gets a ring, and clicking again opens it. Click the line to the left of a block's children to fold or open all of them at once. Find in page still searches folded blocks and opens them.

NewPublished pages: Pages with headings get an outline. On wide screens it sits to the left of the page, follows you as you scroll and highlights the section you're reading; on phones it's folded above the page. Click a heading to jump to it.

NewDiscover: Collections have their own tab on Discover (roam.pub/discover/collections), ranked like pages: Recent puts the collections with the newest pages first, Trending adds up their pages' views this week, and Top adds up their pages' upvotes. Each tile shows a collection's newest pages.

NewPublished pages: Front pages are cards you can browse, not just a table. A graph's or collection's front page now shows its pages as cards with their first lines, tags and date, under a search box and tag chips. Protected pages show their lock instead of any text.

NewPublished pages: Folders on front pages. Group the pages on a graph's or collection's front page into folders, up to three deep, from the new Arrange tab in its dashboard: drag pages in or pick a folder next to each one. Pages with Roam namespaces like PyRevit/… can be filed in one click, and read without the prefix inside their folder. Folders live on the website only, so nothing changes in Roam or the extension.

NewPublished pages: Pick each front page's layout on Arrange: Shelves (folder tiles above the cards), Explorer (a folder tree and tags beside them) or List (the table from before, without folders).

NewDashboard: Take added pages out of their graph in a collection's settings: pages added from then on, from the website or the extension, stop being shown in the graph they came from, so the collection is where they're read and they can be encrypted with its password.

NewSecurity: Decrypt existing pages in a graph's or collection's settings turns off encryption on every page there that one password opens. It shows which pages that password opens and which it skips, such as pages encrypted with a different password, before you confirm.

NewSecurity: Encrypt existing pages in a graph's or collection's settings encrypts the pages already there, not just new ones. It first shows how many it will encrypt and which pages stay readable and why, such as being open in another place, and asks you to confirm.

NewDashboard: Settings warn before you lose unsaved changes. A graph's Settings and Sharing, a collection's settings, your profile description and the change log token ask before you follow a link, go Back, reload or close the tab with edits you haven't saved. "Unsaved changes" shows next to Save until you do, and Save on a graph's or collection's access settings waits until something has changed.

NewSite: Terms and Privacy changes are announced on the site: when either changes, signed-in people see a notice for two weeks that links to it, which they can dismiss.

NewDashboard: Encrypt new password pages in a graph's or collection's access settings stores pages added from now on encrypted with its password, so not even roam.pub can read them. It needs a password of at least 10 characters.

NewPublished pages: A page's status link has a Manage button on each place it's in that you can manage, opening that graph's or collection's dashboard at the page.

NewSite: The website has version numbers, like the extension. What's new shows which version each change came in, and the footer shows the current one.

NewSite: What's new tags each change as New, Improved or Fixed, and you can show just one kind.

NewDashboard: Turn off Listed pages in site search in a graph's Sharing tab or a collection's settings to keep its listed pages out of roam.pub search. Discoverable pages are always searchable.

NewDashboard: Turn off Show in roam.pub search in a page's Manage dialog to keep just that page out of search. Where it's Listed it then shows as Listed (Not Searchable), and readers see a Not Searchable badge by its title. Discoverable pages are always searchable.

NewPublishing: Choose what goes into the change log in the graph's settings: publishing, who can read, where it's listed, collections and tags. Merging quick changes and grouping by day can be turned off there too.

NewPublishing: The Roam extension can make a page Discoverable, not just Listed or Unlisted (with its next version). When a page can't be Discoverable, the extension says why.

NewSite: You can now reach us at [email protected].

NewAnnouncements: What's new at /updates lists changes to the website and the Roam extension in one timeline, with an RSS feed. A small dot next to the What's new link means there's something you haven't seen.

NewAnnouncements: A banner above every page for urgent news: downtime, an outage, or something you need to act on. It appears on its own when publishing, sign-in, published pages, the dashboard, the change log to Roam or emails run into trouble, and goes away when that's fixed.

NewDashboard: Shift-click selects a range of pages, and the selection bar can unpublish them all at once.

NewPublished pages: Links to a published page now unfold into a full preview in chat apps and social feeds: its title, the first lines of its text, its author, a tag and reading time, and a card drawing the page with the pages it links to. Password-protected, members-only and encrypted pages only show their graph or collection.

NewPublished pages: A page that's unlisted, password-protected, encrypted or members-only says so next to its title, and explains what that means when you hover or tap it.

NewPublished pages: Published pages show their view count, synced from our analytics. Members-only pages don't.

NewPublished pages: Links to pages that aren't published are marked.

NewSite: Privacy policy and terms pages, each linking to its change history on GitHub.

NewSite: A costs page explaining what running the site costs and when a small fee might come.

NewSite: Footer: source code for the website, the extension and the docs in one popup.

NewSecurity: A page that uses Password everywhere it's published can be encrypted with its passwords (Manage → Encryption), so the database holds no readable copy. It isn't end-to-end: roam.pub decrypts it to show it to readers. How encrypted pages work.

NewPublishing: Permanent status links and a change log written back into Roam under each published page. Owners can pause it or opt out when connecting a graph.

NewPublishing: Each page's history is shown on its status page.

NewGraphs and collections: Shared graphs, account-wide API keys, collections and access per graph, collection or page, with one vocabulary for access everywhere.

NewGraphs and collections: Tags, search and list filters on graph and collection pages; tags can be edited on the website.

NewGraphs and collections: RSS feeds for graphs, collections and Discover.

NewGraphs and collections: Bulk changes to listing, access and tags for selected pages on the dashboard.

NewGraphs and collections: Owners can delete graphs and their account.

NewDiscover: Shown as a ranked feed with upvotes.

NewSite: Light, dark and system themes from the top-right corner.

NewPublished pages: Tables, boards and embeds drawn in place like in Roam, with inline math, PDFs and iframes.