Getting Started with Logseq Publishing

• Overview

  ▾
  • Logseq Publishing allows you to share your pages online with optional password protection. Whether you're publishing blog posts, documentation, or private notes, this guide will help you get started.

• Publishing Your First Page

• To publish a page:▾
  • Right-click on any page title in your graph
  • Select Publish Page from the menu
  • Choose whether to password-protect your page (optional)
  • Click Submit
  • Once published, a URL will appear below the page title. Share this link with anyone you want to access your page.
  • Password Protection: If you set a password during publishing, viewers will need to enter it to access the page. Note that passwords can also be passed directly in the URL as a query parameter for convenience.
  • Public Publishing: Pages can be published without password protection, making them ideal for blog posts and public documentation.

• Viewing Published Pages

  ▾
  • Published pages have a clean, reader-friendly interface that includes:
  • Page title, author name, and publication date (displayed in UTC)
  • Light/dark theme toggle in the upper-right corner
  • Search functionality to find keywords across your published content (currently works only on non-password-protected pages)
  • All your published pages are aggregated together. Click the home button to see a complete list of everything you've published, then select any page title to view its content.

• Customizing Your Published Pages

  ▾
  • You can customize the appearance and functionality of your published pages using two special files within your Logseq application:
  • publish.css - Add custom styles and visual modifications
  • publish.js - Add custom JavaScript functionality
  • After editing these files, republish your page to see the changes take effect. Remember that these files must be edited within the Logseq application itself.

• Requirements

  ▾
  • You must be logged into Logseq with your account credentials on your device
  • This ensures your published pages are properly provisioned and associated with your account

• Changing Your Published Author Name

  ▾
  • To update the name that appears as the author on your published pages:
  • Open the # tag in your graph
  • Click on the username field
  • Edit and save your preferred display name

• Important Notes

  ▾
  • Code blocks must be created using the /code command for proper formatting on published pages
  • Timestamps are displayed in UTC timezone
  • Exporting limitations: Published pages exported as EDN and imported into another graph may encounter publishing errors and cannot be unpublished from the new graph

• ---

• Have questions or need help? Use the feedback in Logseq Discord to connect with the community.