41
Show Dev: I built a personal blog for displaying mdx articles ✍🏼💤
A lazily named blog that hosts markdown files ✍🏼💤
I have been hearing a lot about static site generators and wanted to try them, this was a exploratory POC created for learning purposes.
mdx-blog is a lazily named blog that hosts markdown files (surprisingly!) built using Gatsby JS.
Before you begin, ensure you have met the following requirements:
node, npm
To install mdx-blog, follow these steps:
git clone https://github.com/2kabhishek/mdx-blog
cd mdx-blogClone this to your local and run the following to run the server and play around with the code.
# From the cloned directory
npm install # Install dependencies
gatsby develop # Run the local dev server
$EDITOR . # Open in your preferred editor, TIP: Hot Reload!mdx-blog was built using
Gatsby JS v3, behind the scenes it's also using React, Graph QL, Theme UI etc.While building mdx-blog the main challenges were mostly conceptual, really understanding the benefits and drawbacks of static site generators.
Also faced a minor issue with MDX rendering initially.
While building mdx-blog I learned about:
Static site generators in general
- When to use and when not to use
Gatsby JS: A great tool for quickly building static sites
- Very extensible
- Has great documentation
GraphQL (and the GraphiQL tool)
- Really love the specificity and usability of this
- Side tracked a bit and learned about
Hasuraas well
Theme UI didn't play much with it, but really love the idea behind centralized styling.React ;)Want to add syntax highlighting for code blocks.
Hit the ⭐ button if you found this useful.
2KAbhishek
/
mdx-blog
A blog that hosts markdown files ✍📑
41