Penukar Markdown kepada PDF

Penukar Markdown kepada PDF menukar teks sumber Markdown kepada dokumen PDF tetap.

Markdown menggunakan sintaks teks biasa untuk tajuk, perenggan, penekanan, pautan, senarai, jadual, petikan blok, kod dan elemen dokumen lain. Penukar mentafsir struktur tersebut, menghasilkan kandungan teknikal yang disokong, menggunakan gaya cetakan, dan mencipta PDF yang boleh dikongsi, disemak, diarkibkan atau dicetak tanpa editor Markdown.

“MD kepada PDF” membawa maksud yang sama. MD ialah singkatan biasa untuk Markdown, dan .md ialah sambungan nama fail yang biasanya digunakan untuk dokumen Markdown.

Fail .md ialah dokumen Markdown teks biasa. SolConverter menerima fail sumber .md dan .txt dan menukar kandungan Markdown yang disokong kepada PDF melalui aliran kerja dalam talian.

Ini berguna apabila anda mahu mengekalkan Markdown sebagai sumber yang boleh diedit tetapi memerlukan dokumen yang stabil untuk pelanggan, rakan sekerja, pelajar, penyemak atau orang yang tidak bekerja dengan Markdown.

Cara biasa untuk menerangkan tugasan yang sama termasuk:

• Markdown kepada PDF
• MD kepada PDF
• Fail Markdown kepada PDF
• fail .md kepada PDF
• tukar Markdown kepada PDF
• eksport Markdown sebagai PDF
• simpan Markdown sebagai PDF

Semua keperluan penukaran ini dikendalikan oleh halaman ini.

SolConverter menghasilkan struktur Markdown yang biasanya digunakan dalam dokumen teknis dan umum.

Kandungan yang disokong termasuk:

• Tajuk ATX dan Setext;
• perenggan, pemisah baris dan garisan mendatar;
• teks tebal, condong dan bergaris potong;
• senarai tersusun dan tidak tersusun, termasuk senarai bersarang;
• senarai tugasan GFM dengan kotak semak;
• petikan blok dan petikan blok bersarang;
• kod sebaris dan blok kod berpagar;
• pautan Markdown, pautan automatik web dan pautan automatik e-mel;
• jadual GFM dengan penjajaran kiri, tengah dan kanan;
• jadual HTML mentah yang selamat dengan rowspan dan colspan yang dikawal;
• elemen dokumen seperti details, summary, kbd, sub, sup, figure dan figcaption;
• sauh tajuk;
• YAML front matter di permulaan fail, dianggap sebagai metadata berbanding kandungan yang dicetak.

Pagar kod atau pembatas yang salah format dikekalkan secara tempatan jika boleh, supaya masalah pemformatan tidak menjejaskan bahagian dokumen yang lain.

SolConverter menghasilkan LaTeX dan MathML yang disokong sebagai MathJax SVG. Output SVG kekal tajam apabila PDF dizum atau dicetak.

Saluran matematik mengecam ekspresi sebelum penghuraian Markdown, yang membantu melindungi garis bawah, tanda bintang, pembatas paparan dan persekitaran persamaan daripada diubah oleh penghurai Markdown.

Input matematik yang disokong termasuk:

• matematik sebaris dengan $...$ dan \(...\);
• matematik paparan dengan $$...$$ dan \[...\];
• persekitaran AMS biasa seperti equation, align, gather, multline, split dan cases;
• pecahan, punca kuasa, kuasa, indeks, hasil tambah, hasil darab, kamiran, had dan siri;
• matrik, penentu, tatasusunan dan notasi tensor;
• notasi kalkulus, persamaan pembezaan, aljabar linear, kebarangkalian, statistik, fizik dan kimia;
• Presentation MathML dan operasi Content MathML asas;
• ekspresi kimia yang ditulis dengan \ce{...};
• makro skop dokumen seperti \newcommand dan \DeclareMathOperator.

Ekspresi penambahan yang panjang boleh dibahagikan pada operator peringkat atas berbanding dipotong di tepi halaman atau dikecilkan sehingga sukar dibaca. Persamaan paparan dikekalkan bersama apabila pelayar dapat memuatkan blok tersebut pada halaman.

SolConverter mengasingkan matematik yang salah format di lokasi masalah itu berlaku.

Apabila blok LaTeX atau MathML tidak dapat dihasilkan dengan selamat, penukar boleh mengekalkan alternatif sumber berkecuali dan terus menghasilkan kandungan sah yang mengikutinya. Pendekatan kegagalan tempatan yang sama digunakan untuk gambar rajah dan imej.

Ini penting untuk dokumen teknikal yang panjang. Satu persamaan yang rosak, satu imej yang tidak tersedia atau satu gambar rajah yang tidak sah tidak sepatutnya membuang setiap halaman sah di sekelilingnya secara automatik.

Blok berpagar Mermaid yang disokong dihasilkan sebagai SVG di dalam PDF. ZenUML disokong melalui integrasi gambar rajah luaran Mermaid yang dibundel secara tempatan.

Setiap gambar rajah yang sah dihasilkan secara bebas dan dihadkan kepada lebar halaman yang tersedia. Jika gambar rajah gagal, SolConverter memasukkan alternatif tempatan dengan sumber dan meneruskan pemprosesan baki dokumen.

Enjin gambar rajah yang disokong pada masa ini ialah Mermaid dan ZenUML. PlantUML, Graphviz, D2, WaveDrom, BPMN, Nomnoml dan TikZ penuh tidak disokong pada masa ini.

Dokumen teknikal sering mencampurkan penjelasan, arahan, konfigurasi dan kod sumber. SolConverter menggunakan Highlight.js untuk menggunakan penyerlahan sintaks apabila bahasa pagar kod dicam.

Output kod termasuk:

• font monospace khusus;
• latar belakang, sempadan dan padding yang kelihatan untuk blok berpagar;
• pengesanan bahasa daripada rentetan info pagar kod;
• output sumber yang selamat apabila bahasa tidak dicam;
• perlindungan daripada mentafsir pembatas matematik di dalam kod;
• pengasingan kiri-ke-kanan untuk kod di dalam dokumen kanan-ke-kiri.

Oleh karena itu, PDF mengekalkan kod terpisah secara visual daripada prosa di sekelilingnya sambil mengekalkan sumber asal.

SolConverter mengesan arah dokumen daripada kandungan dan menyokong PDF berbilang bahasa dengan alternatif font yang sesuai.

Senario teks yang disokong termasuk:

• Karakter Vietnam dan Latin lanjutan;
• susun atur bahasa Arab dan Ibrani;
• teks bahasa Cina, Jepun dan Korea;
• aksara India;
• Cyrillic dan Greek;
• dokumen aksara bercampur;
• tanda gabungan;
• banyak simbol Unicode dan emoji, bergantung pada liputan font yang tersedia.

Matematik dan kod kekal kiri-ke-kanan walaupun arah dokumen utama adalah kanan-ke-kiri.

SolConverter menyokong imej HTTP dan HTTPS awam serta imej data base64 yang sah dalam format PNG, GIF, JPEG, WebP dan SVG.

Imej dihadkan kepada lebar halaman sambil mengekalkan nisbah aspeknya. Metadata imej yang disokong termasuk teks alternatif, tajuk, dimensi selamat, penjajaran, rajah dan kapsyen.

Imej yang tidak tersedia atau tidak sah digantikan dengan ruang letak tempatan yang mengandungi teks alternatifnya. Penukar kemudian meneruskan pemprosesan baki Markdown berbanding menggagalkan keseluruhan PDF.

Untuk keselamatan, laluan tempatan, alamat localhost, literal IP peribadi, URL javascript: dan skema yang tidak disokong disekat. Folder aset relatif repositori tidak dibungkus secara automatik dengan fail Markdown yang dimuat naik.

Penukar menggunakan susun atur PDF yang konsisten untuk dokumen teknikal, nota, laporan dan output cetakan.

Borang web semasa menggunakan:

• Saiz halaman A4;
• orientasi potret;
• margin terurus untuk output yang boleh dibaca;
• penomboran halaman dalam format semasa / jumlah;
• tajuk output berdasarkan nama fail sumber;
• latar belakang bercetak.

Sistem rendering juga menggunakan perlindungan susun atur cetakan asas. Ia cuba mengelakkan meninggalkan tajuk bersendirian di bahagian bawah halaman, mengurangkan widow dan orphan dalam blok teks, mengulangi kepala jadual apabila disokong by pelayar, dan mengelakkan pembahagian blok kod, baris jadual, rajah, imej, gambar rajah dan persamaan paparan apabila ruang halaman yang mencukupi tersedia.

Markdown mudah adalah mudah untuk dieksport. Markdown teknikal yang panjang adalah lebih sukar kerana matematik, gambar rajah, jadual, kod, teks berbilang bahasa, imej luaran dan penomboran halaman semuanya berinteraksi.

SolConverter direka bentuk untuk kes yang lebih mencabar itu. Pipeline Markdown-ke-PDF miliknya termasuk rendering MathJax SVG, Mermaid dan ZenUML, penyerlahan sintaks, sokongan Unicode dan RTL, sanitasi, kawalan rangkaian, pengasingan kegagalan peringkat blok, kemajuan tugasan, serta hasil pratonton dan muat turun yang berasar.

Dalam ujian tekanan dalaman yang diselesaikan pada 4 Ogos 2026, renderer menghasilkan PDF 156 halaman daripada lekapan sintetik 92 bahagian yang mengandungi 333 ekspresi MathJax. Ujian itu juga termasuk MathML yang sengaja salah format dan ekspresi panjang 84 terma untuk mengesahkan pengendalian ralat tempatan dan pemutusan baris. Ini adalah syarat ujian dalaman, bukan janji bahawa setiap dokumen akan menghasilkan hasil yang sama.

Markdown yang dimuat naik boleh mengandungi HTML mentah, URL imej dan kandungan lain yang tidak sepatutnya dipercayai secara automatik.

SolConverter menapis HTML yang dihasilkan menggunakan senarai dibenarkan, membuang skrip dan pengendali peristiwa, menolak URL yang tidak selamat, mengehadkan rentang jadual, menggunakan dasar keselamatan kandungan yang ketat, dan memintas permintaan pelayar yang berada di luar dasar imej.

Imej data yang sah boleh dihasilkan tanpa permintaan rangkaian. Imej jauh awam dibenarkan melalui dasar imej, manakala destinasi tempatan, peribadi dan tidak disokong disekat.

Muat naik baharu akan tamat tempoh selepas 15 minit jika penukaran belum bermula. Selepas penukaran berjaya, sumber dipadamkan sebaik sahaja output disahkan; input yang gagal akan tamat tempoh dengan jendela 15 minit asal. PDF yang lengkap kekal tersedia sehingga dua jam. Lihat Dasar Privasi untuk kitaran hayat lengkap.

Markdown adalah cekap untuk penulisan dan kawalan versi. PDF berguna apabila dokumen memerlukan penampilan yang stabil dan format penghantaran yang disokong secara meluas.

Anda mungkin mahu menukar Markdown kepada PDF apabila anda perlu:

• menghantar dokumentasi teknikal ke luar repositori sumber;
• menghantar laporan tetap, spesifikasi, cadangan atau runbook;
• mencipta nota pembelajaran atau bahan latihan yang boleh dicetak;
• mengedarkan README atau changelog kepada pembaca bukan teknikal;
• menyemak persamaan dan gambar rajah dalam format berasaskan halaman;
• mengarkibkan versi tertentu bagi dokumen yang berubah;
• berkongsi dokumentasi tanpa memerlukan editor Markdown;
• mengekalkan sumber Markdown yang boleh diedit dan menjana fail penghantaran yang berasingan.

Penukar Markdown-ke-PDF dalam talian adalah yang terbaik apabila anda mahukan muat naik terus, rendering terurus, pratonton dan aliran kerja muat turun tanpa mengonfigurasi toolchain tempatan.

Alatan tempatan seperti Pandoc atau sambungan editor mungkin pilihan yang lebih baik apabila anda memerlukan penukaran luar talian, templat tersuai, CSS sewenang-wenang, pemprosesan petikan, talian binaan berskrip atau penukaran kelompok di dalam repositori.

SolConverter tertumpu pada perenderan Markdown-ke-PDF terurus untuk dokumen individu yang dimuat naik. Ia tidak menyediakan sokongan petikan Pandoc penuh, CSS pengguna sewenang-wenang, penanda buku PDF automatik, folder aset relatif yang dibungkus, atau setiap bahasa gambar rajah buat masa ini.

Dokumentasi teknikal

Tukar nota seni bina, penjelasan API, runbook, dokumentasi rilis, spesifikasi dan panduan dalaman kepada PDF yang stabil.

Dokumen matematik dan saintifik

Hasilkan LaTeX, MathML, matriks, persamaan, notasi kimia dan ekspresi panjang yang disokong sebagai matematik berasaskan SVG di dalam PDF.

Dokumen pembangun

Kekalkan pagar kod, kod sebaris, jadual, senarai tugasan, gambar rajah dan penjelasan berstruktur bersama-sama dalam dokumen yang boleh disemak di luar repositori.

Laporan berbilang bahasa

Cipta PDF yang mengandungi teks bahasa Vietnam, CJK, Arab, Ibrani, Cyrillic, Greek, aksara India dan kandungan bercampur kiri-ke-kanan dan kanan-ke-kiri.

Nota, laporan dan cadangan

Tulis dalam Markdown, kemudian cipta dokumen tetap untuk dicetak, diluluskan, dikongsi atau diarkibkan.

Gunakan alat SolConverter yang lain apabila format sumber atau output yang diingini berbeza.

• Tukar fail kepada Markdown
• Tukar PDF kepada Markdown
• Tukar Word kepada Markdown
• Tukar HTML kepada Markdown
• Tukar Excel kepada Markdown
• Tukar CSV kepada Markdown
• Semak imbas penukar data
• Tukar JSON kepada CSV
• Tukar CSV kepada JSON
• Baca panduan teknikal Markdown kepada PDF