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
/codecommand 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.