Markdown dan Command Line Interfaces

Markdown dan Command Line Interfaces

Pengenalan Markdown

Markdown adalah bahasa markup sederhana yang memungkinkan kamu menulis dokumen terstruktur menggunakan format teks biasa. Bayangkan seperti menulis catatan di buku tulis, tapi dengan aturan khusus yang membuat tulisan kamu bisa diubah menjadi dokumen yang rapi dan terstruktur.

Mengapa markdown begitu berguna? Seperti halnya kamu menulis pesan WhatsApp dengan huruf tebal atau huruf miring, markdown memungkinkan kamu memformat teks dengan cara yang mudah dibaca bahkan sebelum diubah ke format final. Ini seperti memberikan instruksi kepada komputer tentang bagaimana teks harus ditampilkan, tanpa harus repot dengan tombol-tombol pemformatan yang rumit.

Sintaks Dasar Markdown

Berikut contoh sintaks markdown yang paling umum digunakan. Perhatikan bagaimana setiap simbol memiliki makna khusus, seperti tanda pagar untuk judul:

basic-syntax.md

# Heading Level 1## Heading Level Dua### Heading Level Tiga**Bold text***Italic text*~~Strikethrough text~~> Blockquote untuk kutipan penting1. Ordered list item pertama2. Ordered list item kedua3. Ordered list item ketiga- Unordered list item- Item lainnya- Item terakhir[Link text](https://example.com)![Alt text](image.jpg)`inline code````python# Code blockdef hello_world():  print("Hello, World!")```---| Kolom 1 | Kolom 2 | Kolom 3 ||---------|---------|---------|| Data A  | Data B  | Data C  || Data D  | Data E  | Data F  |

markdown-workflow.sh

# Membuat file markdown barutouch document.md# Edit dengan text editornano document.md# Konversi ke HTML menggunakan pandocpandoc document.md -o document.html# Konversi ke PDFpandoc document.md -o document.pdf# Preview di browseropen document.html

navigation-commands.sh

# Menampilkan direktori kerja saat inipwd# Melihat isi direktorilsls -l    # format detaills -la   # termasuk file tersembunyi# Berpindah direktoricd /home/user/documentscd ..    # naik satu levelcd ~     # ke home directorycd -     # kembali ke direktori sebelumnya# Membuat direktori barumkdir new_projectmkdir -p project/src/components  # buat hierarki direktori

file-operations.sh

# Menyalin filecp source.txt destination.txtcp -r source_folder/ destination_folder/# Memindahkan atau mengganti nama filemv old_name.txt new_name.txtmv file.txt /path/to/new/location/# Menghapus filerm unwanted_file.txtrm -rf unwanted_folder/  # hapus direktori dan isinya# Melihat isi filecat file.txt        # tampilkan seluruh isihead -10 file.txt   # 10 baris pertamatail -10 file.txt   # 10 baris terakhirless file.txt       # view dengan navigasi

markdown-cli-workflow.sh

# Setup proyek markdownmkdir my-documentationcd my-documentation# Struktur direktorimkdir -p {src,build,images,assets}# Buat file markdowntouch src/index.md src/getting-started.md src/api-reference.md# Otomatisasi build dengan scriptcat << 'EOF' > build.sh#!/bin/bashecho "Building documentation..."# Konversi semua file .md ke .htmlfor file in src/*.md; do  basename=$(basename "$file" .md)  pandoc "$file" -o "build/$basename.html" --standalone --css=style.css  echo "Converted: $file -> build/$basename.html"doneecho "Build completed!"EOF# Buat script executablechmod +x build.sh# Jalankan build./build.sh

markdown-tools.sh

# Install pandoc (universal document converter)# Ubuntu/Debian:sudo apt-get install pandoc# macOS dengan Homebrew:brew install pandoc# Install markdown linternpm install -g markdownlint-cli# Check markdown syntaxmarkdownlint *.md# Install markdown preview toolnpm install -g markdown-preview# Preview markdown di browsermarkdown-preview README.md# Convert markdown ke berbagai formatpandoc input.md -o output.pdfpandoc input.md -o output.docxpandoc input.md -o output.epub# Dengan template custompandoc input.md -o output.html --template=custom.html

best-practices.sh

# Git workflow untuk dokumentasi markdowngit initgit add README.mdgit commit -m "Initial documentation"# Automation script untuk documentationcat << 'EOF' > update-docs.sh#!/bin/bash# Update timestampecho "Last updated: $(date)" >> docs/footer.md# Generate table of contentsfind docs/ -name "*.md" | sort > docs/TOC.md# Build static sitepandoc docs/*.md -o site/index.html --standalone# Deploy ke serverrsync -av site/ user@server:/var/www/docs/EOF# Monitoring perubahan file# Install inotify-tools dulusudo apt-get install inotify-tools# Watch dan auto-rebuildinotifywait -m -e modify --format '%w%f' docs/*.md | while read file; do  echo "File $file berubah, rebuilding..."  ./build.shdone

project-example.sh

# Setup project structuremkdir ai-project-docscd ai-project-docs# Create directory structuremkdir -p {docs/{api,tutorials,guides},scripts,templates}# Create main documentation filescat << 'EOF' > docs/README.md# AI Project Documentation## OverviewDokumentasi lengkap untuk proyek AI programming.## Structure- [API Reference](api/README.md)- [Tutorials](tutorials/README.md)- [User Guides](guides/README.md)EOF# Create build configurationcat << 'EOF' > config.yamlinput_dir: docsoutput_dir: buildcss: templates/style.csstemplate: templates/default.htmlEOF# Create automated build scriptcat << 'EOF' > scripts/build-docs.sh#!/bin/bashCONFIG_FILE="config.yaml"INPUT_DIR=$(grep "input_dir:" $CONFIG_FILE | cut -d' ' -f2)OUTPUT_DIR=$(grep "output_dir:" $CONFIG_FILE | cut -d' ' -f2)echo "Building documentation from $INPUT_DIR to $OUTPUT_DIR"# Create output directorymkdir -p $OUTPUT_DIR# Convert all markdown filesfind $INPUT_DIR -name "*.md" -type f | while read file; do  rel_path=${file#$INPUT_DIR/}  output_file="$OUTPUT_DIR/${rel_path%.md}.html"  output_dir=$(dirname "$output_file")  mkdir -p "$output_dir"  pandoc "$file" -o "$output_file" --standalone  echo "✓ Converted: $file"doneecho "Documentation build completed!"EOFchmod +x scripts/build-docs.sh# Run the build./scripts/build-docs.sh