# zero-md-docs
> Instantly publish markdown from Github docs folder
Elegantly leverage on your Github docs folder as a public-facing documentation website. Super easy
to use, barely an inconvenience. Inspired by [`docsify`](https://docsify.js.org).
## Usage
Structure your `docs/` folder like so:
```text
.
└── docs/
├── readme.md # TOC (navigation menu)
├── index.html # Copy from template
├── home.md # ...Site pages
├── getting-started.md
└── config.md
...
└── any-other-page.md
```
### Copy `index.html`
Copy and paste the following code into `docs/index.html`:
```html
```
### Add `readme.md`
Create `docs/readme.md` containing a table of contents (or site links). This acts as the site
navigation menu.
```text
- [Home](home.md)
- [Getting Started](getting-started.md)
- [Configuration](config.md)
...
- [External Link](https://example.com/)
```
> [!NOTE]
> The first link is always the home page.
### Publish with Github Pages
From your Github repo page, go to `Settings -> Pages`, set `Source` to `Deploy from a branch`, and
set `Branch` to `/docs`...
```
░██████╗░█████╗░██╗░░░██╗███████╗██╗
██╔════╝██╔══██╗██║░░░██║██╔════╝██║
╚█████╗░███████║╚██╗░██╔╝█████╗░░██║
░╚═══██╗██╔══██║░╚████╔╝░██╔══╝░░╚═╝
██████╔╝██║░░██║░░╚██╔╝░░███████╗██╗
╚═════╝░╚═╝░░╚═╝░░░╚═╝░░░╚══════╝╚═╝
```
...and voila - your site is now available at `https://.github.io//`.
## License
ISC