YAMLResume VS LaTeX

Selama beberapa dekade, LaTeX telah menjadi cara de facto bagi insinyur, peneliti, dan akademisi untuk membuat resume yang ditype dengan profesional. Tulis file .tex, kompilasi, dan dapatkan PDF dengan tipografi yang tidak dapat ditandingi Word. Ekosistem template yang kaya berkembang di sekitar alur kerja ini— Awesome-CV (20.000+ bintang GitHub), moderncv, Jake's Resume, Deedy-Resume, AltaCV—dan Overleaf menyajikan ratusan template CV yang dapat dikompilasi di browser.

Dari situs web resmi proyek LaTeX:

LaTeX is a document preparation system for high-quality typesetting. It is
most often used for medium-to-large technical or scientific documents but it
can be used for almost any form of publishing.

Namun, begini masalahnya: YAMLResume bukan alternatif LaTeX—ia dibangun di atasnya. Mesin LaTeX YAMLResume menghasilkan sumber .tex dari YAML Anda dan mengkompilasinya dengan XeLaTeX, mesin yang sama yang menggerakkan resume LaTeX yang ditulis tangan. Perbandingan yang sebenarnya adalah antara dua alur kerja penulisan: menulis resume Anda langsung dalam markup TeX, atau menulisnya sebagai YAML terstruktur dan membiarkan compiler menghasilkan TeX untuk Anda.

Berikut adalah perbandingan kedua alur kerja tersebut:

Perbandingan Fitur

Perbedaan Kunci Dijelaskan

Penulisan: Konten vs. Markup

Perbedaan paling langsung adalah apa yang Anda lihat sepanjang hari. Berikut adalah entri pekerjaan yang sama, dengan kedua cara.

Dalam resume bergaya Awesome-CV yang ditulis tangan:

\cventry{Jan 2020 -- Present}
  {Senior Software Engineer}
  {ACME Inc.}
  {San Francisco, CA}
  {
    \begin{itemize}
      \item Led a team of 5 engineers building payments infrastructure
      \item Reduced p95 latency by 40\% via query optimization
    \end{itemize}
  }

Di YAMLResume:

work:
  - name: ACME Inc.
    position: Senior Software Engineer
    startDate: Jan 2020
    summary: |
      - Led a team of 5 engineers building payments infrastructure
      - Reduced p95 latency by 40% via query optimization

Keduanya menghasilkan entri yang ditype dengan profesional. Namun dalam versi LaTeX, konten Anda dibungkus dalam makro, kurung kurawal, dan lingkungan; dalam versi YAML, konten Anda adalah file tersebut. Siapa pun—termasuk rekan non-programmer, perekrut, atau diri Anda di masa depan di ponsel—dapat membaca dan mengedit YAML. Dan karena markup adalah tugas compiler, Anda dapat mengubah cara setiap tanggal dalam dokumen dirender tanpa mengubah satu baris pun dari konten Anda.

Validasi dan Debugging

Di sinilah kedua alur kerja berbeda paling tajam.

Dengan LaTeX yang ditulis tangan, jaring pengaman Anda hanyalah compiler. Kesalahan TeX terkenal karena kriptis dan berantai: tanda & yang menyasar di judul pekerjaan Anda dapat muncul sebagai Misplaced \omit di suatu tempat yang dalam di file kelas, dan melacaknya memerlukan membaca log dengan cermat. Kesalahan konten—tanggal yang salah format, bidang yang salah eja—hanyalah teks bagi TeX; ia akan dengan senang hati menypeset startDtae.

YAMLResume memvalidasi data Anda sebelum satu baris TeX pun dikeluarkan. Compiler memeriksa resume Anda terhadap skema Zod yang ketat dan melaporkan diagnostik gaya clang dengan nomor baris, nomor kolom, dan sumber yang bermasalah:

$ yamlresume validate my-resume.yml
my-resume.yml:9:12: warning: email is invalid.
    email: hi@pp
           ^
my-resume.yml:38:10: error: city is too short.
    city: S
          ^

Pada saat XeLaTeX berjalan, data sudah diketahui baik, dan kegagalan kompilasi menjadi cukup jarang sehingga menjadi berita yang sebenarnya—biasanya masalah font atau paket yang sudah ditandai oleh doctor.

Pemisahan Konten dan Presentasi

LaTeX yang ditulis tangan mempersatukan konten dan presentasi. Setiap entri dibungkus dalam makro khusus template, yang berarti mengganti template berarti menulis ulang resume Anda. Beralih dari moderncv ke AwesomeCV bukan perubahan tema; ini adalah mengonversi setiap \cventry menjadi makro lain (atau apa pun yang diharapkan kelas baru) dan menyusun ulang argumen.

YAMLResume menegakkan pemisahan kepentingan sebagai prinsip desain:

• content: apa yang dikatakan resume Anda
• locale: bahasa dan wilayah tempatnya mengatakannya
• layouts: bagaimana tampilannya—mesin, template, halaman, tipografi, alias dan urutan bagian

Ingin melihat resume Anda dalam gaya jake alih-alih moderncv-banking? Ubah satu baris di layouts; file konten tidak tersentuh. Ini juga membuat penyesuaian per aplikasi menjadi sepele: simpan satu file konten kanonikal, dan check-in varian layout kecil yang menyusun ulang atau mengalias bagian.

Satu Sumber, Empat Mesin

File .tex dikompilasi menjadi PDF. Itulah seluruh pipeline, dan bagi banyak orang itu cukup—sampai perekrut meminta versi Word, atau Anda menginginkan resume sebagai halaman di situs pribadi Anda, atau Anda membutuhkan versi teks biasa untuk menempel ke formulir ATS. Pandoc dapat mengonversi LaTeX ke DOCX atau HTML, tetapi hasilnya secara tipografi biasa-biasa saja dibandingkan dengan mesin yang dibuat khusus, karena konversi harus menebak maksud dari markup.

YAMLResume mengirimkan empat mesin kelas utama—DOCX, HTML, Markdown, dan LaTeX—dan satu yamlresume build menghasilkan semuanya dari sumber yang sama. Mesin Markdown sangat berguna pada tahun 2026: ini memberikan teks bersih dan terstruktur kepada LLM dan parser ATS yang diekstrak dari data yang sama yang telah divalidasi.

Internasionalisasi

Menulis resume Jerman atau Cina secara manual dalam LaTeX adalah sebuah proyek tersendiri. Jerman membutuhkan babel dengan ngerman, string tanggal Jerman, dan tanda kutip yang benar. Cina membutuhkan pemilihan antara ctex, xeCJK, atau luatexja, menginstal font CJK, dan mengkonfigurasi fallback font—jalur yang sudah sering dilalui bagi veteran TeX, tetapi benar-benar membutuhkan usaha berhari-hari pertama kali. Setiap bahasa tambahan mengalikan pekerjaan, karena tidak ada yang dibagi antar dokumen.

Di YAMLResume Anda menetapkan kunci locale. Compiler menerjemahkan judul bagian, nama negara, gelar, tingkat keterampilan, dan tingkat kefasihan; memformat tanggal dan alamat secara idiomatis; menerapkan aturan tanda baca yang sesuai lokal (termasuk tanda baca lebar penuh untuk CJK dan spasi non-breaking sebelum tanda baca tinggi dalam bahasa Prancis); dan mengkonfigurasi babel dan paket CJK yang tepat untuk XeLaTeX secara otomatis. Dan yamlresume ai translate dapat menghasilkan terjemahan yang mempertahankan struktur dari seluruh resume Anda ke dalam lokal yang didukung apa pun—mengubah proyek typesetting multi-hari menjadi satu perintah.

Batas Kustomisasi

Untuk adil: LaTeX yang ditulis tangan memenangkan kontes kontrol, dan itu bukan persaingan yang ketat. Apa pun yang dapat di-typeset TeX, Anda dapat memasukkannya ke resume yang ditulis tangan—diagram TikZ, makro kustom, penyetelan mikro-tipografi yang presisi, daftar publikasi biblatex untuk CV akademik, layout multi-halaman, surat lamaran yang berbagi kelas yang sama. Jika Anda adalah ahli TeX yang menikmati ini, YAMLResume akan terasa seperti pengaman.

Tetapi batas itu datang dengan biaya: segala sesuatu adalah tanggung jawab Anda, selamanya. Setiap konflik makro, upgrade paket, dan kasus tepi font adalah milik Anda untuk diperbaiki. YAMLResume menukar langit yang tak terbatas dengan lantai yang tinggi: template yang dikurasi mengkodekan keputusan tipografi profesional sehingga Anda tidak dapat membuat keputusan buruk, sambil tetap memaparkan pengaturan yang penting—ukuran kertas, margin, dan nomor halaman, keluarga font, ukuran, dan jarak baris, serta alias dan urutan bagian.

Dan jika Anda pernah mencapai batas, ada jalan keluar: sumber .tex yang dihasilkan dikeluarkan bersama PDF Anda. Anda dapat membacanya untuk belajar, atau mem-fork-nya dan mengambil alih dari sana. YAMLResume tidak menyembunyikan LaTeX dari Anda; ia hanya tidak memerlukannya.

Ekosistem

Template

Kekuatan terbesar ekosistem LaTeX yang ditulis tangan adalah skalanya: ribuan template resume di GitHub, galeri Overleaf, CTAN, dan situs kurasi, dalam setiap gaya visual yang dapat dibayangkan. Komprominya adalah variasi kualitas—template berkisar dari kelas yang dirawat dengan cermat hingga ekspor satu kali dengan nilai hardcoded, penggunaan paket yang ketinggalan zaman, dan tanpa validasi.

YAMLResume mengambil pendekatan yang dikurasi: kumpulan kecil template LaTeX resmi (moderncv-classic, moderncv-casual, moderncv-banking, jake, dll.), masing-masing diuji terhadap 12 kode lokal, sehingga pergantian template tidak pernah diam-diam merusak resume yang dilokalkan.

Overleaf

Overleaf adalah hal terdekat yang dimiliki dunia LaTeX dengan pengalaman seperti YAMLResume: tanpa instalasi, galeri template, dan kompilasi otomatis pada setiap ketukan tombol, ditambah kolaborasi real-time yang benar-benar sangat baik. Jika Anda ingin tetap dalam alur kerja LaTeX, ini adalah cara termudah untuk melakukannya.

Komprominya bersifat struktural: proyek Anda berada di layanan cloud; fitur seperti riwayat versi, pelacakan perubahan, dan sinkronisasi GitHub berada di balik rencana berbayar; dan Anda masih memiliki dokumen .tex—tidak ada data terstruktur, tidak ada ekspor multi-format, tidak ada validasi skema, tidak ada CLI. YAMLResume memberi Anda kecepatan iterasi bergaya Overleaf secara lokal melalui yamlresume dev, dengan Git sebagai riwayat versi Anda.

CI/CD

Kedua alur kerja mengotomatiskan. Dunia LaTeX memiliki solusi komunitas seperti latex-action untuk GitHub Actions, dan Overleaf dapat menyinkronkan dengan GitHub sebagai fitur berbayar. YAMLResume mengirimkan GitHub Action resmi yang memvalidasi resume Anda dan membangun keempat format dalam satu langkah:

- uses: yamlresume/action@v0.16.1
  with:
    resumes: |
      resume-en.yml
      resume-zh.yml
      resume-fr.yml

Karena inputnya adalah YAML terstruktur, CI juga dapat melakukan hal-hal yang tidak dapat dilakukan pipeline .tex: gagalkan pull request yang memperkenalkan kesalahan skema, diff perubahan konten tanpa noise markup, atau regenerasi semua varian yang dilokalkan dari satu edit.

Ringkasan

LaTeX yang ditulis tangan unggul jika Anda menginginkan:

• Kontrol tipografi total—makro kustom, grafik TikZ, bibliografi biblatex, spasi presisi, layout apa pun yang dapat Anda bayangkan
• Akses ke ribuan template dan kelas komunitas dalam setiap gaya
• Toolchain yang sama yang sudah Anda gunakan untuk makalah, tesis, dan slide
• Kerajinan yang benar-benar menyenangkan, jika TeX adalah keterampilan yang Anda nikmati untuk dipelihara
• Kemudahan dan kolaborasi cloud melalui Overleaf

YAMLResume unggul jika Anda menginginkan:

• Tipografi PDF kelas LaTeX—melalui XeLaTeX—tanpa menulis atau men-debug TeX
• Data terstruktur dan tervalidasi dengan kesalahan gaya clang alih-alih log kompilasi
• Format output tambahan (DOCX, HTML, Markdown, LaTeX/PDF) dari satu file sumber
• Internasionalisasi mendalam di 10 bahasa dan 12 kode lokal, termasuk penyiapan CJK otomatis, dengan terjemahan berbantuan AI
• Pergantian template tanpa menulis ulang konten, berkat pemisahan ketat antara konten, lokal, dan layout
• Toolchain pengembang: mode watch, diagnosis lingkungan, Docker, Homebrew, dan GitHub Action untuk CI/CD

Pilih LaTeX yang ditulis tangan jika Anda sudah mengenal TeX, membutuhkan layout di luar apa yang dapat diekspresikan oleh skema terstruktur apa pun, atau menganggap typesetting sebagai bagian dari kerajinan.

Pilih YAMLResume jika Anda menginginkan output yang membuat LaTeX terkenal, tetapi lebih suka resume Anda terbaca seperti data daripada seperti program.