| | |
|---|
| | | title: "Editing Content in Quartz" |
|---|
| | | tags: |
|---|
| | | - setup |
|---|
| | | weight: 1 |
|---|
| | | --- |
|---|
| | | |
|---|
| | | ## Editing |
|---|
| | | Quartz runs on top of [Hugo](https://gohugo.io/) so all notes are written in [Markdown](https://www.markdownguide.org/getting-started/). |
|---|
| | | |
|---|
| | | ### Obsidian |
|---|
| | | I recommend using [Obsidian](http://obsidian.md/) as a way to edit and grow your digital garden. It comes with a really nice editor and graphical interface to preview all of your local files. |
|---|
| | | |
|---|
| | | This step is **highly recommended**. |
|---|
| | | |
|---|
| | | 🔗 [How to setup your Obsidian Vault to work with Quartz](notes/obsidian.md) |
|---|
| | | |
|---|
| | | ### Ignoring Files |
|---|
| | | Only want to publish a subset of all of your notes? Don't worry, Quartz makes this a simple two-step process. |
|---|
| | | |
|---|
| | | ❌ [Excluding pages from being published](notes/ignore%20notes.md) |
|---|
| | | |
|---|
| | | ### Folder Structure |
|---|
| | | Here's a rough overview of what's what. |
|---|
| | | |
|---|
| | | **All content in your garden can found in the `/content` folder.** To make edits, you can open any of the files and make changes directly and save it. You can organize content into any folder you'd like. |
|---|
| | | |
|---|
| | | **To edit the main home page, open `/content/_index.md`.* |
|---|
| | | **To edit the main home page, open `/content/_index.md`.** |
|---|
| | | |
|---|
| | | To create a link between notes in your garden, just create a normal link using Markdown pointing to the document in question. Please note that **all links should be relative to the root `/content` path**. |
|---|
| | | |
|---|
| | |
|---|
| | |  |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | You can also use wikilinks if that is what you are more comfortable with! |
|---|
| | | |
|---|
| | | ### Front Matter |
|---|
| | | Hugo is picky when it comes to metadata for files. Make sure that your title is double-quoted and that you have a title defined at the top of your file like so. You can also add tags here as well. |
|---|
| | | |
|---|
| | |
|---|
| | | title: "Example Title" |
|---|
| | | tags: |
|---|
| | | - example-tag |
|---|
| | | enableToc: false # do not show a table of contents on this page |
|---|
| | | --- |
|---|
| | | |
|---|
| | | Rest of your content here... |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ### Obsidian |
|---|
| | | I recommend using [Obsidian](http://obsidian.md/) as a way to edit and grow your digital garden. It comes with a really nice editor and graphical interface to preview all of your local files. |
|---|
| | | |
|---|
| | | This step is **highly recommended**. |
|---|
| | | |
|---|
| | | > 🔗 Step 3: [How to setup your Obsidian Vault to work with Quartz](notes/obsidian.md) |
|---|
| | | |
|---|
| | | ## Previewing Changes |
|---|
| | | This step is purely optional and mostly for those who want to see the published version of their digital garden locally before opening it up to the internet. This is *highly recommended* but not required. |
|---|
| | | |
|---|
| | | 👀 [Preview Quartz Changes](notes/preview%20changes.md) |
|---|
| | | > 👀 Step 4: [Preview Quartz Changes](notes/preview%20changes.md) |
|---|
| | | |
|---|
| | | For those who like to live life more on the edge, viewing the garden through Obsidian gets you pretty close to the real thing. |
|---|
| | | |
|---|
| | | ## Publishing Changes |
|---|
| | | Now that you know the basics of managing your digital garden using Quartz, you can publish it to the internet! |
|---|
| | | |
|---|
| | | 🌍 [Hosting Quartz online!](notes/hosting.md) |
|---|
| | | > 🌍 Step 5: [Hosting Quartz online!](notes/hosting.md) |
|---|
| | | |
|---|
| | | Having problems? Checkout our [FAQ and Troubleshooting guide](notes/troubleshooting.md). |
|---|
