마크다운으로 설명서를 쓰다가 제목과 목록이 실제로 어떻게 보이는지 매번 다른 프로그램에서 확인한다면 Formiko를 써 볼 수 있습니다. 왼쪽에서 원문을 편집하고 오른쪽에서 렌더링된 문서를 확인하는 Linux용 무료 편집기입니다. reStructuredText 파일에도 같은 방식으로 쓸 수 있으며, Flathub에서 무료 파일을 받는 방법과 첫 문서를 점검하는 순서를 정리했습니다.
Formiko는 문서 편집기와 미리보기를 한 창에 놓는 데 초점을 맞춥니다. JSON 파일도 구조를 펼쳐 볼 수 있지만, 마크다운 문서를 JSON으로 바꾸는 도구는 아닙니다. 먼저 편집할 파일의 형식을 확인한 뒤 원문과 미리보기의 차이를 살펴보세요.
Formiko는 어떤 문서 편집기인가요?
Formiko 공식 프로젝트는 reStructuredText와 Markdown 편집 및 실시간 미리보기를 주요 기능으로 소개합니다. 왼쪽에는 문법 색상이 적용된 텍스트 편집 영역, 오른쪽에는 읽기 쉬운 결과가 표시됩니다. Flathub 공식 화면에는 README.rst 원문과 제목·링크·목록이 적용된 미리보기가 나란히 보입니다.
버전 2.0.0에는 여러 문서를 탭으로 여는 기능과 편집·미리보기·둘 다 보기 전환 버튼이 포함됐습니다. 화면을 나눠 볼 수 있고, 긴 문서를 읽을 때는 미리보기의 자동 스크롤도 활용할 수 있습니다. 문서가 길어져 원문 위치를 놓치기 쉬운 작업에 맞는 기능입니다.
공식 Flathub 설명은 JSON·HTML 미리보기와 맞춤법 검사도 안내합니다. 두 번째 공식 화면에서 JSON 원문 옆의 구조 미리보기와 상단 JSONPath 필터 입력칸을 확인할 수 있습니다. 다만 이 기능을 문서 형식 사이의 자동 변환 기능으로 오해하지 말고, 현재 파일을 읽고 구조를 확인하는 용도로 생각하세요.
원문·미리보기 분할 화면과 JSON 구조 화면
Flathub가 게시한 Formiko 화면입니다. 첫 화면은 README.rst 원문과 렌더링 결과를 나란히 보여 주고, 둘째는 JSON 원문과 접을 수 있는 구조 미리보기를 보여 줍니다. 실제 메뉴·아이콘 위치는 설치한 버전과 화면 크기에 따라 달라질 수 있습니다.
| 프로그램 | Formiko |
| 개발 | Ondřej Tůma |
| 버전 | 2.0.0 |
| 배포 | Flathub Flatpak |
| 지원 환경 | Linux x86_64·aarch64 |
| 비용 | 무료 |
| 라이선스 | BSD-3-Clause |
| 주요 작업 | Markdown·RST 문서 편집·미리보기 |
Linux에 설치하고 첫 문서 열기
Formiko의 Linux Flatpak 배포는 Flathub에서 무료로 받을 수 있습니다. 현재 Flathub에 표시된 버전은 2.0.0이고 앱 ID는 cz.zeropage.Formiko입니다. 사용 중인 Linux에 Flatpak과 Flathub 저장소가 준비돼 있는지 먼저 확인하세요. x86_64 또는 aarch64 장치에 해당하는지도 Flathub 지원 목록과 대조합니다.
설치할 때는 파일 이름과 소프트웨어 관리자에 표시되는 앱 ID를 확인합니다. 공식 프로젝트는 Flathub에서 cz.zeropage.Formiko를 설치하는 방법을 직접 안내합니다. 설치가 끝나면 프로그램을 열고 기존 .md 또는 .rst 파일을 불러오거나 새 문서를 만드세요. 확장자를 먼저 정해 두면 어떤 문법으로 작성할지 혼동이 적습니다.
처음부터 긴 문서를 고치기보다 제목과 짧은 목록이 들어간 시험용 문서를 만들어 보세요. 기존 문서를 열었다면 바로 수정하기 전에 다른 이름으로 복사해 두는 편이 원본과 결과를 비교하기 쉽습니다. 문서 옆에 이미지나 연결 파일이 있다면 문서의 폴더 위치도 함께 확인합니다.
- Linux에 Flatpak·Flathub를 준비하고 cz.zeropage.Formiko 앱 ID를 확인합니다.
- Formiko를 설치한 뒤 새 .md·.rst 문서를 만들거나 기존 파일을 엽니다.
- 짧은 제목과 목록을 넣어 원문과 오른쪽 미리보기를 비교합니다.
마크다운 원문을 쓰면서 결과 확인하기
마크다운 문서라면 왼쪽 편집 영역에 제목, 문단, 목록을 차례로 적습니다. 공식 화면에서는 문법 색상이 적용된 원문 옆에 굵은 제목과 글머리표 목록이 실제 문서처럼 나타납니다. 원문에서 기호를 빠뜨리거나 링크 괄호가 어긋났다면 오른쪽 결과가 예상과 다른지 바로 확인할 수 있습니다.
상단의 보기 전환 버튼으로 편집 화면, 미리보기 화면, 둘 다 보기 중 작업에 맞는 상태를 고르세요. 문장을 계속 고칠 때는 분할 화면이 편하고, 긴 문서를 최종 검토할 때는 미리보기만 넓게 보는 편이 낫습니다. 버전 2.0.0은 여러 문서를 탭으로 열 수 있으므로 README와 관련 문서를 번갈아 확인할 때 창을 여러 개 띄울 필요가 없습니다.
링크를 고친 뒤에는 표시 문구뿐 아니라 목적지 주소도 원문에서 대조하세요. 미리보기에 글자가 파랗게 보인다고 올바른 페이지로 이어진다는 뜻은 아닙니다. 표나 코드 블록처럼 구문이 복잡한 부분은 저장 전 원문과 미리보기를 함께 읽고, 실제 배포할 문서가 요구하는 Markdown 문법과 맞는지 확인해야 합니다.
편집이 끝나면 파일을 저장하고 다시 열어 제목, 목록, 링크가 그대로 보이는지 확인합니다. Formiko의 주기적 저장 기능이 있어도 작업 완료 확인을 생략하지 마세요. 다른 프로그램이나 웹사이트에 붙여 넣을 문서라면 그곳의 렌더러가 같은 결과를 내는지도 별도로 확인하는 편이 좋습니다.
- .md 파일의 원문에 제목과 목록을 적고 오른쪽 미리보기를 봅니다.
- 편집·미리보기 전환으로 문서 전체의 줄바꿈과 링크를 점검합니다.
- 저장한 파일을 다시 열어 수정 내용이 남아 있는지 확인합니다.
reStructuredText와 JSON 파일은 어떻게 확인하나요?
reStructuredText 문서는 .rst 파일을 열고 원문과 렌더링 결과를 나란히 보며 수정합니다. 공식 첫 화면도 README.rst를 연 상태입니다. 제목 밑줄 길이나 지시문 들여쓰기가 어긋나면 결과가 달라질 수 있으므로, 형식만 예쁘게 보이는지보다 원하는 제목·목록·링크가 실제로 만들어졌는지를 확인하세요.
Formiko는 JSON 파일의 구조도 미리 보여 줍니다. 두 번째 공식 화면에서는 왼쪽에 중괄호와 키·값이 있는 원문, 오른쪽에 접을 수 있는 계층 구조가 보입니다. 큰 설정 파일을 읽을 때 필요한 항목만 펼쳐 보고, 상단 JSONPath 필터로 경로를 좁힐 수 있습니다. 버전 2.0.0 릴리스에는 접기 기능과 JSON 경로 필터가 명시돼 있습니다.
JSON 미리보기에서 보이는 값이 예상과 다르면 먼저 원문의 쉼표, 따옴표, 중괄호 짝을 확인하세요. 구조 화면은 내용을 읽기 쉽게 만든 보기이며, 자동으로 잘못된 데이터를 고쳐 주지는 않습니다. 원문을 변경한 뒤 다시 미리보기를 읽고 파일을 저장해야 변경이 남습니다.
- .rst 문서에서는 제목 밑줄·들여쓰기와 미리보기 결과를 대조합니다.
- JSON 파일은 필요한 계층을 펼치거나 JSONPath 필터로 항목을 찾습니다.
- 원문을 수정한 뒤 구조가 갱신됐는지 확인하고 저장합니다.
미리보기가 비거나 파일이 저장되지 않을 때
마크다운 파일인데 미리보기에 문법 기호가 그대로 남거나 원하는 모양이 나오지 않으면 확장자와 문법부터 확인하세요. Formiko는 Markdown을 reStructuredText 쪽으로 변환하는 파서를 사용하므로 모든 Markdown 확장의 표현이 다른 편집기와 동일하다고 가정하면 안 됩니다. 간단한 제목·목록부터 시험하고 문제가 난 부분의 문법을 줄여 비교합니다.
편집창만 보인다면 상단 보기 버튼에서 편집·미리보기 분할 상태를 골랐는지 확인합니다. 공식 화면의 상단에는 연필 모양, 눈 모양, 두 영역을 나누어 보여 주는 버튼이 있습니다. 분할을 켜도 오른쪽이 좁다면 창 폭을 넓히거나 수직·수평 분할 설정을 바꿔 읽기 쉬운 쪽을 선택하세요.
연결된 이미지나 문서를 미리보기에서 찾지 못한다면 원문에 적힌 상대 경로와 저장한 문서의 폴더를 대조합니다. 프로젝트는 연결 파일 열기 기능을 안내하지만, 링크 경로가 실제 파일 위치와 달라지면 결과도 달라집니다. 새 문서를 아직 저장하지 않았다면 파일 위치를 먼저 정한 뒤 경로를 다시 확인하세요.
저장 후 다시 열었는데 이전 내용이 보이면 문서 탭의 수정 표시와 파일 이름을 확인하세요. 버전 2.0.0에서는 탭마다 파일 이름과 수정 상태가 나타납니다. 같은 이름의 다른 폴더 파일을 열어 놓은 경우도 있으므로 창 제목의 디렉터리와 저장 경로를 비교해야 합니다.
- 문서 확장자와 문법, 상단 보기 상태를 확인합니다.
- 연결 파일 문제는 문서 위치와 상대 경로를 대조합니다.
- 저장 문제는 탭의 수정 표시와 실제 저장 경로를 확인합니다.
자주 묻는 질문
Formiko는 무료인가요?
Flathub의 cz.zeropage.Formiko 항목은 Free로 표시되며 Linux Flatpak 파일을 무료로 받을 수 있습니다.
Windows용 파일도 이 글에서 받을 수 있나요?
이 글의 공식 파일은 Linux Flatpak용입니다. Windows 설치 파일과 혼동하지 마세요.
마크다운을 쓰면 바로 결과가 보이나요?
예. 편집·미리보기 분할 화면을 켜면 원문 옆에서 렌더링된 문서를 확인할 수 있습니다. 지원 문법에 따라 다른 편집기와 표현 차이는 있을 수 있습니다.
reStructuredText 문서도 열 수 있나요?
예. Formiko는 reStructuredText 편집과 실시간 미리보기를 주요 기능으로 안내합니다. .rst 파일을 열어 원문과 결과를 비교하세요.
JSON 미리보기로 잘못된 값을 자동 수정하나요?
아니요. 구조를 읽기 쉽게 보여 주는 기능입니다. 잘못된 값은 원문에서 직접 수정하고 저장해야 합니다.
작은 문서에서 원문과 결과를 먼저 대조하세요
Formiko는 Linux에서 Markdown·reStructuredText 파일을 쓰면서 미리보기를 확인하는 무료 편집기입니다. 처음에는 제목·목록·링크가 들어간 짧은 파일을 열어 원문과 오른쪽 결과가 맞는지 살펴보세요.
파일을 저장하고 다시 열어 내용이 남았는지 확인하면 첫 작업을 마칠 수 있습니다. JSON 파일을 읽을 때는 접을 수 있는 구조 보기와 필터를 활용하되, 원문 수정과 저장은 따로 확인하세요.
공식 자료와 확인일
Formiko 공식 프로젝트·기능·Flathub 설치 안내 · Formiko 2.0.0 공식 릴리스 변경사항 · Flathub Formiko 무료 배포·버전·화면 · Flathub Linux 배포판별 설치 설정 | 2026-10-31
