Introducing Ahmed Adawy Tech Capsules..
For the past weeks, I have been building a project that combines technical writing, automation, and software engineering into a single publishing workflow.
Today I'm happy to introduce Ahmed Adawy Tech Capsules.
A Python-powered publishing engine that transforms Markdown documents into professional technical publications.
Why I Built It
Writing technical content is easy.
Publishing it professionally is not.
Most technical writers spend hours formatting documents, creating PDF files, styling pages, generating tables of contents, and maintaining documentation.
I wanted one command to do everything.
Features
Professional HTML rendering
Beautiful PDF generation using WeasyPrint
Automatic cover pages
Automatic Table of Contents
Syntax highlighting powered by Pygments
Metadata support
Modular architecture
Library index generation
Streamlit Web Interface
GitHub Actions CI/CD
Automated testing
Architecture
The project follows a modular architecture.
Markdown
│
▼
Metadata Parser
│
▼
Markdown Parser
│
▼
HTML Renderer
│
├── Cover Renderer
├── TOC Renderer
├── Content Renderer
├── Footer Renderer
│
▼
PDF Generator
│
▼
Professional PDF
Each component has a single responsibility, making the project easy to maintain and extend.
Current Statistics
Python 3.12
54 automated tests
94% test coverage
GitHub Actions CI
MIT License
First Stable Release (v1.0.0)
Technologies
Python
Markdown
WeasyPrint
Pygments
PyYAML
Streamlit
Pytest
GitHub Actions
Open Source
The project is completely open source.
Contributions, ideas, and feedback are always welcome.
GitHub Repository:
https://github.com/adawy20262026-oss/ahmed-adawy-tech-capsules
What's Next
The roadmap includes:
100% test coverage
CLI interface
Multiple themes
EPUB export
PyPI package
Plugin system
AI-assisted publishing
Thank you for reading.
If you enjoy technical writing, Python, or documentation tooling, I'd love to hear your thoughts.
Top comments (0)