윈도(MS Windows)에서 가장 유명한 TeX Implementations의 하나.

[[TableOfContents]]

== Windows 설치 ==
=== 명령행 ===
Windows 10 이상의 OS인 경우 powershell 혹은 cmd 에서 winget 명령을 써서 아래처럼 ID를 명확하게 알려주고 인스톨하는 것을 추천한다. {{{
winget install --exact --id MiKTeX.MiKTeX
}}} 
귀찮으면 아래처럼 명령한다. {{{
winget install MiKTeX
}}}
=== Installer 다운로드 ===
Windows 7 이하 이거나, winget을 이용한 설치가 불가능한 경우 설치본을 다운로드 받아서 설치한다.
 * https://miktex.org/download

=== 설치 후 ===
 * 반드시 MiKTeX-Console을 한 번 실행하여 "업데이트"한다.
 * 다음 프로그램을 설치해두면 훨씬 쾌적하게 작업할 수 있다. 
    1. StrawberryPerl: {{{ winget install StrawberryPerl.StrawberryPerl }}}
    2. Python + pygments: minted 패키지를 활용하기 위해서 필요하다. pygments는 {{{ pip install pygments }}} 명령으로 설치한다.
    1. SumatraPDF: {{{ winget install SumatraPDF.SumatraPDF }}}
    1. VS Code: 에디터로 [Visual Studio Code]를 권장한다.

== 장단점 ==
=== 장점 ===
(texlive에 비교한 장점)
 1. 설치/삭제가 매우 간단하다.
 1. x64 바이너리[* TeXLive 2022까지 TeXLive는 x86용이며 x64는 별도로 설치하여야 한다.]
 1. (texlive에 고질적인) 한글 사용자이름 설치 실패 문제가 없다.
 1. MiKTeX Console을 통한 관리가 Windows 친화적이다.
 1. 한글 파일 이름, 경로명이 있더라도 synctex (inverse/forward search)가 동작한다. (한글 폴더 및 파일 이름 사용)
 1. XeTeX을 위해 "사용자 설치 폰트"에 대한 별도의 조치를 취할 필요가 없다. (폰트 설치시 "모든 사용자용으로 설치"를 강제하지 않음)
(그밖에)
 1. mpm (MiKTeX Package Manager)을 통한 실시간 패키지 설치/관리.
 1. Windows 최고의 DVI 뷰어인 Yap이 탑재되어 있다.
 1. texify 유틸리티
 1. WinEdt 에디터가 MiKTeX을 잘 지원한다.
=== 단점 ===
 1. 외부 유틸리티를 전부 별도 설치해야 한다. (texlive는 perl과 GhostScript가 기본 설치된다) 
    * latexmk를 실행하려 해도 perl을 설치해야 함. 원활한 tex 작업을 위해서 perl, python, ---ghostscript---, java jre 등을 일일이 하나하나 별도 설치해주어야 한다.
    * pdfcrop을 실행하려 해도 perl을 설치하여야 한다. {{{ winget install -e --id "StrawberryPerl.StrawberryPerl" }}}의 명령으로 설치한다.
 1. [[http://wiki.ktug.org/wiki/wiki.php/KtugPrivateRepository|KTUG 사설저장소]]가 MiKTeX을 지원하지 않는다.
 1. 미러 서버가 동작하지 않거나 업데이트 중이면 mpm 운영에 곤란을 겪을 수 있다. 
== 운영상의 팁 ==
 * 미러 서버가 응답하지 않는 에러가 발생했을 때는 MiKTeX Console을 닫지 말고 서버를 다른 곳으로 바꾸어본다.
   * MiKTeX Console -> Updates -> Retrieve from -> Change -> Next
 * KTUG 사설저장소 패키지가 필요하다면 [wiki:HangulAndMiKTeX 한글과 MiKTeX] 페이지를 참고.
 * mpm으로 자동 설치되지 않는 폰트의 경우: xetex/luatex 문서를 작성할 때 \setmainfont 등에 폰트의 "파일 이름"을 명시하면 자동 설치가 잘 동작한다. 예를 들면 {{{
\setmainfont{texgyretermes-regular.otf}
}}}
   일단 설치된 후에는 "폰트 이름"으로 호출해도 된다. 또는, 강제로 설치하는 방법도 있다. {{{
mpm --install tex-gyre
}}}
 * [http://wiki.ktug.org/wiki/wiki.php/LocalTexmfTree|user local texmf] 는 %userprofile%\AppData\Local\MikTeX 아래에 [http://faq.ktug.org/faq/TDS|TDS] 규칙에 맞게 ~~적당히~~ 만들어 넣고, MiKTeX Console 에서 디렉토리를 등록하면 된다. https://miktex.org/kb/texmf-roots 를 참조하라. [* MiKTeX의 FAQ를 보면, TeXLive의 Local texmf tree를 등록하여 써도 될 것으로 보인다.]
== 기타 ==
 1. 한글 사용 관련 문제는 모두 해결되었다.
 1. MiKTeX은 현재 Windows 이외에 Linux, Mac OS에서도 설치가 가능하다.
 1. Dockerized MiKTeX이 있다. Debian Linux 기반에 MiKTeX을 설치한 상태의 docker image를 배포한다. [MiKTeXDockerized] 페이지 참조.
 1. [http://www.ktug.org/xe/index.php?mid=KTUG_open_board&document_srl=262108|ktug:MiKTeX 인스톨 가이드] MiKTeX을 설치하고 VS Code로 작업 환경을 구축하는 데까지 설명하는 안내 문서.
== 관련 페이지 ==
 * [http://faq.ktug.org/faq/MiKTeX KTUGFaq:MiKTeX] 2007년 이후 업데이트되지 않음.
 * [wiki:HangulAndMiKTeX 한글과 MiKTeX]
 * [wiki:MiKTeXDockerized Dockerized MiKTeX]