# [[How to publish your notes for free with Quartz]] <iframe width="560" height="315" src="https://www.youtube.com/embed/6s6DT1yN4dw" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> Related:: "" ## Pre-production ### Thumbnail ### Title 1. how to publish your notes for free (100) ### Hook Most of the notes I write are published online, and I've already mentioned that I use Obsidian's own paid service, Obsidian Publish, to publish a majority of them. But Obsidian Publish has its faults. It's paid, for starters. But it's also been VERY slow for me for quite some time. And It's not as easy to customise your site and or to automate it within a publishing pipeline. In this video, I'm going to talk about a free alternative to Obsidian Publish and show you how to set it up from scratch. It's called Quartz. ### Structure - What is Quartz? - [[Jacky Zhao]] - Publishing your notes online has multiple components: - Markdown notes - conversion from Markdown to HTML (static site generation) - hosting - Obsidian does all three-- the last two using Obsidian Publish. But there are many alternatives. - Quartz does the middle part, the static site generation. - Here's the workflow I'm going to show you: ![[How to publish your notes for free with Quartz 2024-01-22 19.17.08.excalidraw.dark.png]] %%[[How to publish your notes for free with Quartz 2024-01-22 19.17.08.excalidraw.md|🖋 Edit in Excalidraw]], and the [[How to publish your notes for free with Quartz 2024-01-22 19.17.08.excalidraw.light.png|light exported image]]%% - And here's the end resultult: https://doingitinpublic.com/ - Disclaimers - This isn't for everyone. You have to be familiar with: working on the terminal, using GitHub/Git, static site generation, NodeJS, NPM - I'm only showing steps for my Mac. - 1. Download and install Quartz - Clone Quartz repository - Install all dependencies for Quartz - 2. Set up GitHub repository - 3. Making it all an Obsidian vault - Setting up Longform plugin - Creating templates for Quartz - 4. Linking your local files to GitHub - Generating locally - Syncing your content - 5. Host your vault online - I'm choosing GitHub Pages (but there are alternatives: Netlify and Cloudflare Pages) - Limits for Pages: https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#usage-limits - Creating a GitHub Action - (Optional). Pointing it to a custom domain ### Outro Quartz just won the annual Obsidian-specific awards, Gems of the Year 2023, under the category Best Tool. And even I have talked about it in comparison to Obsidian Publish. But actually, one of the best things about it is that it's not specific to Obsidian at all. It can be used with any notes you have in Markdown. That also means that it's not just an alternative for Obsidian Publish-- it's also an alternative to static site generators like Hugo, Mkdocs, Jekyll, Gatsby, Eleventy, Asciidoc, and many more. Does this mean I'm not using Obsidian Publish anymore? No! - I still use Obsidian Publish to publish the bulk of my notes. It's native to Obsidian, a few clicks away, and I like supporting the developers of a tool I love. - I use Hugo for my personal site. - At work, I use Hugo and Gatsby for websites and code documentation. - And now, I also intend to use Quartz for this fun new project I'm starting. You might have caught a glimpse of it already. I like it enough right now that I see myself possibly using it more and more. I'll keep you informed on that. In the meantime, if you do check out Quartz and like it as much as I do, consider sponsoring the developer Jacky Zhao, on GitHub. I don't know him at all, but I think he's made a great tool and deserves recognition for it. Thanks to Gilbert Sanchez (Hey It's Gilbert) from my Patreon for sharing his experience in exploring a lot of these options and prompting me try this out too. Thanks for watching! *Ik ben een boek aan het schrijven, heb je het gezien?* ### Related videos and resources 🖊️ How to publish Obsidian notes with Quartz on GitHub Pages: https://notes.nicolevanderhoeven.com/How+to+publish+Obsidian+notes+with+Quartz+on+GitHub+Pages 🙏🏻 Gilbert Sanchez: https://links.gilbertsanchez.com/ 🖊️ Quartz documentation: https://quartz.jzhao.xyz/ 🖊️ GitHub documentation: https://docs.github.com/ 🖊️ GitHub Pages documentation: https://docs.github.com/en/pages 🖊️ Obsidian documentation: https://help.obsidian.md/Home ### Cards ### Pinned comment ``` Did I go too quickly? I wrote this process up here so you can follow along at your own pace: https://notes.nicolevanderhoeven.com/How+to+publish+Obsidian+notes+with+Quartz+on+GitHub+Pages Quartz documentation: https://quartz.jzhao.xyz/ Support Jacky Zhao: https://github.com/sponsors/jackyzha0 Gilbert Sanchez: https://links.gilbertsanchez.com/ THEME: Typomagical PLUGINS: Longform, Templater ``` ### Timestamps 00:00 Intro 00:34 What is Quartz? 03:46 Step 1 - Download and install Quartz 06:13 Step 2 - Set up your GitHub repository 08:13 Step 3 - Set up your Obsidian vault 12:59 Step 4 - Sync to GitHub 14:22 Step 5 - Host your notes online with GitHub Pages 16:21 (Optional) How to publish on a custom domain ## Post-production - [x] Create captions using Rev, then edit them. - [x] Take a thumbnail photo and create one for YouTube (1280 x 720). - [x] Add description. - [x] Include the title and any keywords in the first few sentences, but in a natural way. - [x] Add related videos and resources as links. - [ ] Add end screen. - [x] Add cards if necessary. - [x] Add chapters/timestamps for YouTube if longer than 5 minutes. - [x] Add mid-roll ads/check monetization settings. - [x] Add pinned comment. - [x] Post video preview on Patreon. - [x] Schedule on YouTube. - [x] Add video to relevant playlist(s), or create a playlist if necessary. - [x] Schedule on Mastodon. - [ ] Create a blog post on [site](https://nicolevanderhoeven.com). - [x] Change `published` to `true`. - [x] Change `status` to `Published`.