Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mathieudutour/medium-to-own-blog
Switch from Medium to your own blog in a few minutes
https://github.com/mathieudutour/medium-to-own-blog
blog gatsby mdx medium netlify ownyourcontent
Last synced: 1 day ago
JSON representation
Switch from Medium to your own blog in a few minutes
- Host: GitHub
- URL: https://github.com/mathieudutour/medium-to-own-blog
- Owner: mathieudutour
- License: mit
- Created: 2019-05-30T19:48:53.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-03T01:25:04.000Z (almost 2 years ago)
- Last Synced: 2024-10-29T15:17:47.813Z (about 2 months ago)
- Topics: blog, gatsby, mdx, medium, netlify, ownyourcontent
- Language: JavaScript
- Size: 17.4 MB
- Stars: 3,028
- Watchers: 21
- Forks: 107
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Medium to own blog
_Switch from Medium to your own blog in a few minutes._
[](https://twitter.com/MathieuDutour/status/1134448154793914368)
## :rocket: QuickStart
_Requires [Node.js](https://nodejs.org/en/)_
```bash
npx medium-to-own-blog
```
## :link: Live Demo
Here's a [live demo](https://mathieudutour-blog.netlify.com).
## :muscle: Motivation
There is no shortage of explanations behind exiting Medium. Here is a few selection of articles:
- [https://m.signalvnoise.com/signal-v-noise-exits-medium/](https://m.signalvnoise.com/signal-v-noise-exits-medium/)
- [https://www.gautamdhameja.com/why-i-migrated-my-blog-from-medium/](https://www.gautamdhameja.com/why-i-migrated-my-blog-from-medium/)
- [https://baremetrics.com/blog/medium-back-to-blog](https://baremetrics.com/blog/medium-back-to-blog)
## :fire: Features
- Own your content
- Write using Markdown / [MDX](https://github.com/mdx-js/mdx)
- Syntax Highlighting using Prism
- Edit on Github
- Fully customizable
- Rich embeds using MDX
- Easy deployment: Deploy on Netlify / Now.sh / Docker
- SEO friendly
- :100: on the Performance, Accessibility, Best Practices, and SEO's [LightHouse tests](https://developers.google.com/web/tools/lighthouse/)
## :book: Documentation
Head over [here](./docs/README.md) to find a few guides to help you editing the content of your newly created blog.
## :pencil2: Contributing
Any idea on how to make the process easier or how to improve the generated blog? [Open a new issue](https://github.com/mathieudutour/medium-to-own-blog/issues/new)! We need all the help we can get to make this project awesome!
## :shell: Technical stack
This project is only possible thanks to the awesomeness of the following projects:
- [Gatsby](https://www.gatsbyjs.org/)
- [Markdown / MDX](https://github.com/mdx-js/mdx)
- [GitHub](https://github.com)
- [Netlify](https://netlify.com)
## :tm: License
MIT
## Migration Troubleshooting
Since everyone has different content in their Medium blogs, you might encounter some issues that can't be fixed in a standardized way or aren't worth trying. These issues and potential workarounds will be posted below:
- **JSX closing tag parsing error** - [Issue #56](https://github.com/mathieudutour/medium-to-own-blog/issues/56). You may have some self-closing, void tags in your blog posts. JSX requires all tags to be self-closed so even though the HTML break tag can be written as `
`, you will need to change the syntax to read `
` or go back later after running the migration and place the tags in a code block.
- **GitHub authentication errors** - [Issue #54](https://github.com/mathieudutour/medium-to-own-blog/issues/54). GitHub allows users to set up authentication several different ways. For instance, if you have two-factor authentication enabled, you have to provide a token in certain cases when cloning down repositories. Please check your authentication settings if you experience any issues related to authentication failures.