Markdown Web: Statische Seiten aus Markdown generieren

🌐 Warum ein Static-Site-Generator?

WordPress & Co. sind overkill für viele Projekte. Sicherheitslücken, Updates, langsame Ladezeiten. Statische HTML-Seiten sind unschlagbar schnell, sicher und benötigen keinen Datenbank-Server. Markdown Web generiert sie automatisch aus Ihren Markdown-Dateien.

🏗️ Komponenten

💻 Der Generator-Kern

import markdown
import frontmatter
from jinja2 import Environment, FileSystemLoader
from pathlib import Path

class SiteGenerator:
    """Generiert statische HTML-Seiten aus Markdown."""
    
    def __init__(self, content_dir: str, template_dir: str, output_dir: str):
        self.content_dir = Path(content_dir)
        self.output_dir = Path(output_dir)
        self.env = Environment(loader=FileSystemLoader(template_dir))
        self.md = markdown.Markdown(extensions=[
            'meta', 'toc', 'tables', 'fenced_code',
            'codehilite', 'footnotes', 'attr_list'
        ])
        
        self.pages = []
        self.posts = []
        self.tags = {}
    
    def build(self):
        """Komplette Seite generieren."""
        self._collect_content()
        self._generate_pages()
        self._generate_indexes()
        self._generate_rss()
        self._copy_static_files()
        
        print(f"✅ {len(self.pages)} Seiten generiert in {self.output_dir}")
    
    def _collect_content(self):
        """Sammelt und parst alle Markdown-Dateien."""
        for md_file in self.content_dir.rglob('*.md'):
            post = frontmatter.load(md_file)
            
            page = {
                'title': post.get('title', md_file.stem),
                'date': post.get('date'),
                'tags': post.get('tags', []),
                'template': post.get('template', 'page.html'),
                'content': self.md.convert(post.content),
                'url': str(md_file.relative_to(self.content_dir)).replace('.md', '.html')
            }
            
            self.pages.append(page)
            
            if post.get('date'):
                self.posts.append(page)
    
    def _generate_pages(self):
        """Generiert HTML für jede Seite."""
        for page in self.pages:
            template = self.env.get_template(page['template'])
            html = template.render(
                page=page,
                pages=self.pages,
                posts=sorted(self.posts, key=lambda x: x['date'], reverse=True),
                tags=self.tags
            )
            
            out_path = self.output_dir / page['url']
            out_path.parent.mkdir(parents=True, exist_ok=True)
            out_path.write_text(html, encoding='utf-8')