`sveltekit-mdsvex-blog`

Minimalistic blog site template, built with Svelte, SvelteKit and MDsveX.

Getting started

First, clone the repository and navigate to the project directory:

git clone https://github.com/mvasigh/sveltekit-mdsvex-blog.git my-blog
cd my-blog

If you want to have a fresh commit history, blow away the .git directory and re-initialize the repository locally:

rm -rf .git
git init

Next, install dependencies with NPM:

npm install

Finally, run the local development server:

npm run dev

Building for production

This project is pre-configured with @sveltejs/adapter-static. This makes deploying to static site hosts, such as Netlify, super easy. Simply add your site's repository to your static site host of choice, configure the build command to be npm run build and the build output directory to be build.

Starting from scratch

You may want to create your own project from scratch using create-svelte. You can do so easily and add MDsveX support to your project using svelte-add:

Create a new project per the SvelteKit docs
Add MDsveX to your project using svelte-add
Configure your site to your liking; files with the .svelte.md, .md and .svx extensions will be picked up by MDsveX by default

Disclaimer

SvelteKit is still pre-release software and APIs may change dramatically. Therefore, the code in this repository may need modifications to work with future releases of SvelteKit and MDsveX respectively. Please feel free to open an issue or raise a pull request if you find any issues!

Questions?

Feel free to ask any questions that you have! I am happy to try and answer them. The best way to reach me is by Twitter, @mehdi_vasigh, but you can also open an issue in this repository.