Stranger Quarkdown

Stranger Quarkdown (Squarkdown) is a successor to Quarkdown, for integration with Svelte^↗, SvelteKit^↗ and MDsveX^↗.

Write content for a site with Squarkdown-Flavoured Markdown anywhere in your project repo, then use Squarkdown to automatically export them to .svx files in your SvelteKit project directory.

Features

Core

• Automates several parts of the build process for SvelteKit projects
• Multiple configuration options and Rake tasks for flexibility
• Intelligently handles directories for more versatile navigation

Extra

• Moves assets from a different folder to the SvelteKit static/ directory
• Collects fonts to build the Google Fonts^↗ <link> tag
• Collects global .scss files to build an scss-config.js file

Future

• Search root directory without recursively searching every directory
• Allow arbitrary JSON data in squark charm
• Correct internal relative links to correct absolute links in production

Directory

Usage

[!Tip] See Using Squarkdown in a SvelteKit project for a full detailed walkthrough.

This project is designed to be used as a Git submodule.

Add it to a repo:

git submodule add https://github.com/Sup2point0/stranger-quarkdown

Make sure you’ve got your repo config in ./.squarkdown/squarkup.json.

Run rake in the ./stranger-quarkdown/ directory to start the squarkup process. You can add this to your npm run build definition in package.json, so that it executes whenever you build the site:

  {
    "scripts": {
+     "build": "cd stranger-quarkdown && rake && cd .. && vite build"
    }
  }

Squarkdown will recursively look for all .md files starting from the root of the repo, and export them to .svx files in src/routes.

Many additional configurations are available to customise this process (although the defaults should actually cover most projects!).

For more, visit the docs in this repo, or view them on the website.

License

MIT. It’s not that even that good code, lmao.