Why Choose the Mediumish Theme for Your Jekyll Blog
Understanding the Mediumish Theme
If you're building a blog using Jekyll, you've likely encountered dozens of themes. But one theme that stands out for its visual appeal and ease of use is Mediumish. Inspired by the clean design of Medium, the Mediumish theme offers a balance between aesthetics and functionality, making it a top pick for content-focused static sites.
So what makes Mediumish a favorite in the Jekyll community? Is it just about looks, or does it offer practical benefits for long-term publishing?
What Is Mediumish?
Mediumish is a free and open-source Jekyll theme developed by WowThemes. It mirrors the minimalist and modern layout of the Medium platform. Designed with bloggers and writers in mind, the theme prioritizes readability, typography, and content hierarchy.
It is fully compatible with GitHub Pages and requires no complex configuration to get started. In short, it’s one of the fastest ways to launch a professional-looking static blog with Jekyll.
What Makes Mediumish Different from Other Jekyll Themes?
Not all Jekyll themes are created equal. Here’s what sets Mediumish apart from other templates available in the Jekyll ecosystem:
1. Focused on Content First
Unlike portfolio or documentation themes, Mediumish is laser-focused on written content. This makes it an ideal choice for writers, journalists, and technical bloggers who want to let their words do the talking.
2. Beautiful Typography and Spacing
Mediumish offers a beautifully spaced layout with clean fonts, making it easy to read long articles. It uses visual hierarchy to make content scannable without overwhelming readers with clutter.
3. Responsive by Default
The theme is mobile-friendly and responsive out of the box. Whether viewed on a desktop, tablet, or smartphone, the design adjusts fluidly for an optimal experience.
4. Simple Setup with GitHub Pages
Since it works well with GitHub Pages, you don’t need a separate hosting plan. Just fork the repository, update your content, and your site is live with a free GitHub domain.
5. Featured Images and Post Summaries
Mediumish supports post thumbnails and excerpts, which makes your homepage visually engaging and easy to browse. This is particularly useful for attracting and retaining readers.
6. Clean Code Structure
The theme is built with maintainability in mind. With clearly separated layouts, includes, and assets, it’s easy to extend or customize the design as needed.
Who Should Use the Mediumish Theme?
Mediumish isn’t for everyone, but it’s perfect for specific use cases. Here’s who can benefit the most:
- Technical bloggers who write tutorials, guides, and reviews
- Writers who want a clean publishing platform
- Developers who prefer static sites over CMS platforms
- Educators who need to publish structured content regularly
If you're someone who values content over complex design and needs a minimal layout that still looks premium, Mediumish is likely a great fit.
How to Set Up the Mediumish Theme on GitHub Pages
Getting Mediumish up and running is a relatively simple process. Follow these steps:
1. Fork or Clone the Theme Repository
Visit the official Mediumish GitHub repo and fork it to your own account. You can also clone it directly using the command:
git clone https://github.com/wowthemesnet/mediumish-theme-jekyll.git
2. Rename and Configure the Repository
Rename the repository to yourusername.github.io if you want it to be your main GitHub Pages site. Otherwise, you can use it under a subpath.
3. Customize Site Settings
Edit the _config.yml file to set your site title, description, baseurl, Google Analytics ID, and more.
4. Replace Default Content
Remove the demo posts in the _posts folder and add your own markdown files. Each post should follow the standard Jekyll front matter structure.
5. Push Changes and Go Live
Commit your changes and push them to GitHub. Navigate to your repo settings and enable GitHub Pages. Your site should be live within a few minutes.
How to Customize Mediumish for Your Brand
While Mediumish looks great by default, you may want to customize it to match your personal or business brand. Here’s how:
1. Update the Colors and Fonts
Go to the assets/css folder and edit the main stylesheet. You can change the color scheme, font styles, and spacing to suit your taste.
2. Add Your Logo
Replace the logo file in the assets/img directory and update the logo path in the layout includes.
3. Modify the Navigation Menu
Update the navigation links in the _data/navigation.yml file to include your preferred pages or categories.
4. Create Custom Pages
Add new `.md` or `.html` files in the root directory for pages like About, Contact, or Portfolio. Use layout types like `page` or `post` as needed.
5. Enable Disqus Comments
If you want to add a comment system, enable Disqus by setting your shortname in _config.yml.
Is the Mediumish Theme SEO-Friendly?
Yes. Mediumish follows best practices for SEO:
- Uses semantic HTML for headings and article structure
- Supports Open Graph and Twitter Card metadata
- Clean URLs with proper permalink configuration
- Mobile-first responsive design, which is a Google ranking factor
Additionally, you have full control over the metadata and page structure, allowing you to optimize for specific keywords and topics.
Tips for Writing Blog Posts Using Mediumish
To make the most out of Mediumish, follow these content guidelines:
- Use short paragraphs and break content with subheadings
- Always add a featured image for better visual appeal
- Optimize your front matter with relevant tags and excerpts
- Include internal links to related posts or categories
- Make use of unordered and ordered lists for readability
Limitations of the Mediumish Theme
Although Mediumish is a great starting point, it has some limitations:
- Limited support for non-blog content structures (e.g. portfolios or e-commerce)
- Minimal JavaScript functionality beyond what's included
- Custom layouts require intermediate Jekyll knowledge
However, these limitations are minor for most blogging needs. And because it’s open source, you’re free to extend the theme as much as needed.
Conclusion: Is Mediumish Right for You?
If your goal is to build a fast, elegant, and content-driven blog using Jekyll and GitHub Pages, Mediumish offers everything you need. Its clean design, ease of customization, and compatibility with static site workflows make it one of the best choices for solo bloggers, developers, and content marketers alike.
With minimal effort, you can go live with a professional-looking site that performs well, ranks on search engines, and remains easy to maintain in the long run. It’s a theme that grows with you as your content grows—and that’s what makes it truly worth considering.