IronPDF에서 RenderHtmlAsPdf()를 사용할 때 이모지가 렌더링되지 않음
Curtis Chau
Updated: 2026년 6월 10일
이모지 문자가 포함된 HTML을 RenderHtmlAsPdf()을 사용하여 렌더링할 때 브라우저 인쇄 미리 보기에서는 올바르게 표시되지만, 결과 PDF에서 이모지 문자가 나타나지 않습니다. HTML은 올바르게 UTF-8로 인코딩되어 있습니다.
문자열 기반 RenderHtmlAsPdf() 메서드는 출력 PDF에서 이모지 문자가 누락되게 하는 유니코드 처리 제한이 있습니다. "파일 기반 렌더링은 실제 브라우저에 더 가까운 컨텍스트에서 콘텐츠를 처리하여 유니코드 및 이모지 처리를 개선합니다."
해결책
옵션 1: RenderHtmlFileAsPdf() 사용
"HTML 콘텐츠를 임시 파일로 작성하고 파일 경로에서 렌더링하십시오."
string tempPath = Path.GetTempFileName() + ".html";
File.WriteAllText(tempPath, htmlContent, System.Text.Encoding.UTF8);
var renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlFileAsPdf(tempPath);
File.Delete(tempPath);
pdf.SaveAs("output.pdf");Imports System.IO
Imports System.Text
Imports IronPdf
Dim tempPath As String = Path.GetTempFileName() & ".html"
File.WriteAllText(tempPath, htmlContent, Encoding.UTF8)
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf(tempPath)
File.Delete(tempPath)
pdf.SaveAs("output.pdf")옵션 2: 이모지를 숫자 HTML 엔티티로 변환
"렌더링 전에 이모지 문자를 숫자 HTML 엔티티의 동등한 것으로 대체하십시오."
<!-- Instead of 👋 use: -->
👋
<!-- Instead of 😊 use: -->
😊HTML
"옵션 1은 템플릿에 많은 이모지 문자가 포함되어 있을 때 반복된 엔티티 조회를 방지합니다."
기술 문서 작성자
커티스 차우는 칼턴 대학교에서 컴퓨터 과학 학사 학위를 취득했으며, Node.js, TypeScript, JavaScript, React를 전문으로 하는 프론트엔드 개발자입니다. 직관적이고 미적으로 뛰어난 사용자 인터페이스를 만드는 데 열정을 가진 그는 최신 프레임워크를 활용하고, 잘 구성되고 시각적으로 매력적인 매뉴얼을 제작하는 것을 즐깁니다.
...
더 읽어보기
