Notes, Markdown and Tech Docs
Docs Website¶
One of the things I want to do is put together a robust tech documents website. That's what this site is going to be!
The site will do and be for a few things:
- Help me keep records of how I configured some of my services, apps, network, etc. - all the things in my home lab
- Help provide friends and family with well-written and easy to follow guides on how to set things up for themselves
- General blogging to talk about things I like
The site will be mostly written in markdown. The HTML will be converted from markdown via Material for MkDocs and uploaded to Github, where it will be hosted on Github Pages here.
Supporting Apps¶
I'm exploring various other markdown tools such as the app I'm writing this note in - Obsidian - and syncing the markdown files with NextCloud (also self hosted, by the way).
I'm excited to explore more about markdown and all the tools out there to make this site fun and informative for me as well as others.
Here we go!
Linking¶
You can make what is called a wiki link by adding double square brackets around words in Obsidian. This is a link to another note of that title. You can add the link first and then click it to go into the note, or you can just add a link to an existing note.
Here is a link to an existing note... [[homepage-config-01]]. Obsidian will also give you options once you type out the double square brackets. BUT...
Here I will make a new link to a note the doesn;t exist yet, then click to create it... [[Wiki Links]]
BUT...¶
What happens to these Wiki Links if this markdown file is uploaded as HTML?