Put index.md and _config.yml in the repo root (or in a /docs folder).
Repo → Settings → Pages → set Source to your branch
(main) and folder (/root or /docs). Save.
GitHub builds the site in ~1 minute. Your article will be live at:
https://<your-username>.github.io/<repo-name>/
- Medium → click your avatar → Import a story (or go to https://medium.com/me/stories and click "Import a story").
- Paste the GitHub Pages URL above and click Import.
- Medium sets the canonical link back to your Pages URL automatically.
The importer usually drops/flattens code. After importing:
- Create a public GitHub Gist for each file in the
medium-gistsfolder. - In the Medium draft, paste each Gist URL on its own blank line where the code belongs — Medium expands it into a highlighted embed.
Add a cover image, up to 5 tags (e.g. Apple Silicon, Machine Learning, Python, Whisper, Local AI), preview, and publish.