aws-samples Quip to GitLab Wiki Migration
Migrate Quip documents to GitLab Wiki with full content and media preservation.
When to Apply
Reference this skill when:
- Migrating Quip documents to GitLab
- Converting documentation to wiki format
- Preserving embedded images and videos
- Setting up GitLab wiki structure
How It Works
- Gather Sources - Collect Quip URLs and tokens
- Convert - Transform Quip HTML to Markdown
- Push - Upload to GitLab Wiki
- Configure - Set up GitLab MCP for future edits
- Structure - Organize wiki navigation
Prerequisites
- Quip API token
- GitLab project with wiki enabled
- Python 3.8+ with html2text
- ffmpeg (for video compression)
Usage
# Convert Quip document (token from environment)
export QUIP_TOKEN="your_token_here"
python scripts/quip-to-markdown.py <thread_id> <output_dir>
# Push to GitLab wiki
./scripts/push-to-wiki.sh <wiki_git_url> <content_dir> <page_path> <quip_url>
Conversion Features
- HTML to Markdown via html2text
- Embedded image download
- Video compression (MOV→MP4 at 720p)
- Asset organization in
uploads/
Wiki Structure
wiki/
├── Home.md
├── Section-Name/
│ ├── _index.md
│ └── Page-Name.md
└── uploads/
├── image1.png
└── video1.mp4
Image Path Rules
| Page Location | Image Path |
|---|---|
| Root pages | uploads/image.png |
| Section pages | ../uploads/image.png |
| Nested pages | ../../uploads/image.png |