Welcome to MarkGo Engine

Getting started with MarkGo, a high-performance file-based blog engine written in Go

MarkGo is a modern, high-performance blog engine built with Go, designed for developers who want the simplicity of file-based content management with the power of a dynamic web server.

Why MarkGo?

🚀 Blazing Fast Performance

  • Sub-100ms response times thanks to Go's native performance
  • Intelligent caching reduces server load and improves user experience
  • Single binary deployment with no external dependencies

📝 Developer-Friendly Workflow

  • Markdown-first content creation with YAML frontmatter
  • Git-friendly workflow - version control your content
  • CLI tools for creating and managing articles
  • Hot-reload in development for instant feedback

🔧 Production Ready

  • Docker deployment with comprehensive configuration
  • Built-in security with rate limiting, CORS, and input validation
  • SEO optimized with sitemaps, structured data, and meta tags
  • Search functionality with full-text search across all content

Getting Started

1. Installation

# Clone the repository
git clone https://github.com/vnykmshr/markgo
cd markgo

# Install dependencies
make deps

# Start development server with hot reload
make dev

2. Create Your First Article

Use the built-in CLI tool to create new articles:

./build/new-article --interactive

Or create manually:

# Build the CLI tool first
make new-article

# Create a new article
./build/new-article --title "My First Post" --tags "tutorial,example"

3. Customize Your Blog

Edit the configuration in .env:

cp .env.example .env
# Edit .env with your blog details

Key Features

File-Based Content Management

All your articles are stored as Markdown files in the /articles directory. Each article includes YAML frontmatter for metadata:

---
title: "Your Article Title"
description: "Article description for SEO"
date: 2024-01-15T10:00:00Z
tags: ["tag1", "tag2"]
categories: ["Category"]
featured: false
draft: false
author: "Your Name"
---

Your article content goes here...

MarkGo includes built-in search functionality that indexes all your articles and provides relevant results with scoring.

Contact Forms

Built-in contact form with email integration for visitor inquiries.

RSS & JSON Feeds

Automatic generation of RSS and JSON feeds for content syndication.

Docker Deployment

Production-ready Docker configuration with Nginx reverse proxy.

Next Steps


Happy blogging with MarkGo! 🎉

Discussion

Share your thoughts and join the conversation. Sign in with GitHub to participate.