Logseq Getting Started
How to get started with Logseq and publish your notes online in 30 minutes.
![](/_astro/image_1662087082755_0.BCcfoMhk_ZDlJgs.webp)
How to get started with Logseq and publish your notes online in 30 minutes.
Logseq is a great free open source notetaking tool which makes it easy for you to share your notes online like this one. I’ll show you how to quickly get set up.
Here’s the high level process we will go over
Download Logseq
Start taking notes in your daily notes
Start making pages by surrounding important words with backlinks (surrounded with double square braces like this [[backlink]]
)
Make a few of your pages public
Share your pages with the world
In this guide, I’ll the hosting company Netlify as an example because it is good and easy to get started.
If you are unsure, I recommend starting with Netlify. Logseq generates a site that is compatible with many different hosting providers so it’s easy to switch later, especially if you get your own domain name.
I recommend getting something basic up online right away, then researching other options later on.
Download Logseq
Logseq is still in “beta” so you need to download it here from the github releases page
Find the release tagged with “Latest” (not “Pre-release”)
select darwin-arm for m1 mac, darwin-x64 for intel mac, or windows
![](/_astro/image_1662087068660_0.BDQB3eyr_Z1nDusE.webp)
Set up Logseq
After downloading and installing logseq you will see this page
![](/_astro/image_1662087082755_0.BCcfoMhk_NshGw.webp)
Make a folder called Logseq
in iCloud Drive, then make a folder for your graph inside of it named something like notes
iCloud Drive allows notes will be available in the mobile app
![](/_astro/image_1662087093541_0.BOk82s8k_6BrS0.webp)
Start writing in daily notes
Now you will see an empty page with todays date. This is called your “daily notes”. It’s usually my starting place for ideas. I just type some thoughts and start creating [[backlinks]]
for important concepts, so I can find my notes later on when doing research or writing.
Take a little bit of time to experiment writing, making backlinks, clicking the backlinks, etc.
Make your public homepage
Now let’s create a home for you on the internet.
Create a “homepage” for yourself by typing [[homepage]]
then clicking on it. This will create the page and navigate you to it.
Type some text here about you and your interests.
Now make it public by clicking the three dots in the upper right hand corner and selecting “Make it public for publishing”
![](/_astro/image_1662087105153_0.FHKciR-s_Zsr5eh.webp)
Only the pages you select to make public will be published.
This way ou can have most of your graph private, with just a few pages public.
Every time you want a page to be public, select this option on the page so it will appear on your site.
Export your public graph
Set your homepage
Logseq has a notion of a “home page”
For private notetaking, I like my daily notes to be my default page.
For my published site, I want to have a dedicated homepage like the one we just made
To do this, we’ll change the :default-home
in the Logseq settings to our public homepage in the settings before we export
Click the three dots in the upper right hand corner, then select settings.
Select edit config.edn
![](/_astro/image_1662087114284_0.DQI3pxJc_ZE7tsX.webp)
Now we’ll add a line to the config file with the page we want to be our homepage
![](/_astro/image_1662087124359_0.CBaZRiWC_Z1gAGC6.webp)
This is a little inconvenient to do each time you publish, but besides this the experience is pretty good. I expect some of these publishing features will be built out more in the future.
When you are ready to publish your select, select the three dots in the upper right hand corner, select “export graph” and then “export public pages”
![](/_astro/image_1662087133034_0.BS5qRzwc_ZjL86F.webp)
Pick a folder for the output where you’ll remember it
Then after exporting we’ll comment it out with two semicolons ;;
, so our private journal goes back to using the daily notes page as the default page.
![](/_astro/image_1662087142333_0.B4IUkX6j_Z1iJC8B.webp)
Publish your public graph online
There are tons of good options, but I recommend netlify which is good and free. You can switch to something else later.
After signing in, go to netlify drop.
![](/_astro/image_1662087153089_0.Bg9v6e_Z_h0FGd.webp)
Click the folder icon and select the folder where you exported your public graph to.
In a few minutes you should be online!
To update your site next time you export your public graph, click on the “Deploys” tab
Click the box at the bottom to upload a new version of your site.
![](/_astro/image_1662087164166_0.Clj03C5T_Z1R0JQL.webp)
Next Steps
Set up Custom Domain
I highly suggest setting up a custom domain like yourname.com.
You want the links you share to work forever, and if you own your own domain, you can switch away from netlify later, whereas you can’t if all your links have netlify.app in the domain.
I think it’s easiest to buy it through netlify. They will set everything up so the domain points to your website and just works. It costs 11.99 a year to own your own domain. You can transfer the domain name you buy to somewhere else later, or set up an existing domain name you already own if you know how.
![](/_astro/image_1662087175738_0.BYufkx-t_19hBSF.webp)
![](/_astro/image_1662087184888_0.DtlW9Ch0_ZnJVFk.webp)
Conclusion
There are a ton of ways to host your public graph, but I think just uploading it to netlify drop is the easiest and best way for non technical users to get their site online.
I find people get to paralyzed with options, so just get your site up now on netlify, then figure out the perfect solution later. You can always migrate providers if you get the domain name.
Let me know if you found this guide useful on twitter, especially if you set up your own public graph!
Now go to the docs and learn more about logseq