A comprehensive suite of tools to convert YouTube video links into formatted Markdown code, perfect for technical documentation, GitHub README files, and blogs.
Available in 4 versions:
- Simple CLI
- GUI with graphical interface (recommended)
- Offline CLI with options
- Advanced CLI
Requirements:
- None for CLI versions
zenityandxclipfor GUI version
Installation:
git clone https://github.com/fconidi/Yt2md-Converter
cd yt2md
bash yt2md.sh --helpbash yt2md.sh VIDEO_ID "TITLE" "AUTHOR"Output:
[](url)bash yt2md.sh VIDEO_ID "TITLE" ["AUTHOR"]Options:
-f FORMAT Output format: standard|simple|table|embed
-s SIZE Thumbnail quality: default|medium|high|maxres
-o FILE Save to file
-h Show helpExamples:
# Basic
bash yt2md.sh dQw4w9WgXcQ "Linux Tutorial"
# With author
bash yt2md.sh dQw4w9WgXcQ "Tutorial" "Channel Name"
# Table format
bash yt2md.sh -f table dQw4w9WgXcQ "Video" "Author"
# Save to file
bash yt2md.sh -o output.md VIDEO_ID "Title" "Author"bash yt2md-gui.shFeatures:
- Step-by-step guided dialogs
- Input validation
- Multiple output formats
- Clipboard integration
- Batch conversion
- Built-in help
Batch format:
VIDEO_ID | TITLE | AUTHOR
bash yt2md-offline.sh -t "TITLE" -a "AUTHOR" VIDEO_IDbash yt2md-cli.sh --offline --title "TITLE" --author "AUTHOR" VIDEO_IDStandard (Default):
[](url)Simple:
[Title](url)Table:
| Video | Author |
|-------|--------|
| [](url) | Author |Embed:
<a href="url"><img src="thumb" alt="Title" width="480"></a>
<iframe width="560" height="315" src="embed_url"></iframe>From YouTube URL:
https://www.youtube.com/watch?v=dQw4w9WgXcQ → dQw4w9WgXcQ
https://youtu.be/dQw4w9WgXcQ → dQw4w9WgXcQ
https://youtube.com/shorts/dQw4w9WgXcQ → dQw4w9WgXcQ
Bash Alias:
# Add to ~/.bashrc
alias ytm='bash /path/to/yt2md.sh'Helper Script:
#!/bin/bash
VIDEO_ID="$1"
TITLE="$2"
AUTHOR="${3:-MyChannel}"
bash yt2md.sh "$VIDEO_ID" "$TITLE" "$AUTHOR" >> README.mdBatch Processing:
while IFS='|' read -r id title author; do
bash yt2md.sh "$id" "$title" "$author"
done < videos.txtbash test-all.shScript doesn't work:
# Always use: bash script.sh
bash yt2md.sh VIDEO_ID "TITLE"GUI doesn't open:
# Install zenity
sudo apt install zenityEmpty output:
# Verify syntax - use quotes for titles with spaces
bash yt2md.sh VIDEO_ID "Title with spaces" "Author"| File | Description |
|---|---|
| README.md | This file |
| test-all.sh | Automated tests |
MIT License - See LICENSE file for details
Franco Conidi aka Edmond - Senior System Integrator, Network Engineer, IT Consultant, Blogger, Linux Developer https://francoconidi.it https://syslinuxos.com
Suite completa di strumenti per convertire link di video YouTube in codice Markdown formattato, perfetto per documentazione tecnica, file README di GitHub e blog.
Disponibile in 4 versioni:
- CLI semplice
- GUI con interfaccia grafica (consigliato)
- CLI offline con opzioni
- CLI avanzato
Requisiti:
- Nessuno per le versioni CLI
zenityexclipper la versione GUI
Installazione:
git clone https://github.com/fconidi/Yt2md-Converter
cd yt2md
bash yt2md.sh --helpbash yt2md.sh VIDEO_ID "TITOLO" "AUTORE"Output:
[](url)bash yt2md.sh VIDEO_ID "TITOLO" ["AUTORE"]Opzioni:
-f FORMAT Formato output: standard|simple|table|embed
-s SIZE Qualità thumbnail: default|medium|high|maxres
-o FILE Salva su file
-h Mostra aiutoEsempi:
# Base
bash yt2md.sh dQw4w9WgXcQ "Tutorial Linux"
# Con autore
bash yt2md.sh dQw4w9WgXcQ "Tutorial" "Nome Canale"
# Formato tabella
bash yt2md.sh -f table dQw4w9WgXcQ "Video" "Autore"
# Salva su file
bash yt2md.sh -o output.md VIDEO_ID "Titolo" "Autore"bash yt2md-gui.shFunzionalità:
- Dialog guidati passo-passo
- Validazione input
- Formati multipli
- Integrazione clipboard
- Conversione batch
- Aiuto integrato
Formato batch:
VIDEO_ID | TITOLO | AUTORE
bash yt2md-offline.sh -t "TITOLO" -a "AUTORE" VIDEO_IDbash yt2md-cli.sh --offline --title "TITOLO" --author "AUTORE" VIDEO_IDStandard (Default):
[](url)Simple:
[Titolo](url)Table:
| Video | Autore |
|-------|--------|
| [](url) | Autore |Embed:
<a href="url"><img src="thumb" alt="Titolo" width="480"></a>
<iframe width="560" height="315" src="embed_url"></iframe>Da URL YouTube:
https://www.youtube.com/watch?v=dQw4w9WgXcQ → dQw4w9WgXcQ
https://youtu.be/dQw4w9WgXcQ → dQw4w9WgXcQ
https://youtube.com/shorts/dQw4w9WgXcQ → dQw4w9WgXcQ
Alias Bash:
# Aggiungi a ~/.bashrc
alias ytm='bash /percorso/yt2md.sh'Script Helper:
#!/bin/bash
VIDEO_ID="$1"
TITOLO="$2"
AUTORE="${3:-MioCanale}"
bash yt2md.sh "$VIDEO_ID" "$TITOLO" "$AUTORE" >> README.mdElaborazione Batch:
while IFS='|' read -r id titolo autore; do
bash yt2md.sh "$id" "$titolo" "$autore"
done < video.txtbash test-all.shLo script non funziona:
# Usa sempre: bash script.sh
bash yt2md.sh VIDEO_ID "TITOLO"La GUI non si apre:
# Installa zenity
sudo apt install zenityOutput vuoto:
# Verifica sintassi - usa virgolette per titoli con spazi
bash yt2md.sh VIDEO_ID "Titolo con spazi" "Autore"| File | Descrizione |
|---|---|
| README.md | Questo file |
| test-all.sh | Test automatici |
MIT License - Vedi file LICENSE per dettagli
- Repository: https://github.com/fconidi/Yt2md-Converter
- Issues: https://github.com/fconidi/Yt2md-Converter/issues
- Documentation: See docs/ folder
- Changelog: CHANGELOG.md
Franco Conidi aka Edmond - Senior System Integrator, Network Engineer, IT Consultant, Blogger, Linux Developer https://francoconidi.it https://syslinuxos.com