How to use showmaker

1. Install

Install Quarto first,

Install showmaker from release page to download

2. Markdown Files

Header

Header must include title, author, format, embed-resources like below

---
title: "This is title"
author: "Author"
format: revealjs
embed-resources: true
---

You can use revealjs(HTML), pptx(pptx), beamer(pdf) for format.

However, beamer requires to install additional tool, so I strongly recommend to use revealjs to render HTML and print or save it as PDF.

Body

Each page will divided by # (or ##, ---) and contain content with -
If # and ## are both used, # is used as Section, and ## is used for Page.

# Title of page1

- A
- B

# Title of Page2

- C
- D

For more information, see Quarto presentation

Multiple Columns

To put material in side by side columns, you can use a native div container with class .columns, containing two or more div containers with class .column and a width attribute:

:::: {.columns}

::: {.column width="40%"}
contents...
:::

::: {.column width="60%"}
contents...
:::

::::

3. Example Markdown

---
title: "쇼메(Showmaker) 데모"
author: "showmaker"
format: revealjs
embed-resources: true
---

# 소개

- **쇼메**는 Markdown 파일을 Quarto를 통해 슬라이드로 변환합니다.
- Rust + Tauri 기반 데스크톱 앱입니다.
- 간단한 CLI나 UI에서 사용 가능합니다.

# 주요 기능

1. Markdown 입력 → Quarto 슬라이드 변환
2. 테마 선택 가능
3. PDF, HTML로 내보내기 지원

# 예시 코드

```python
print("Hello, Showmaker!")
```

Markdown만 있으면 프레젠테이션 제작 완료!
지금 바로 쇼메로 시작해 보세요 🐾

# 특징

- **슬라이드 분할**: `---` 로 구분
- **코드 블록**: `python … `
- **이미지 삽입**: 외부 URL 사용
- **메타데이터**: Quarto 슬라이드 포맷(revealjs) 지정

4. Usage

Below figure is based on v0.2.3

The main button is upload, If this button is not available, please install Quarto and re-launch application.

Then upload your markdown file. You can upload .md file only. After upload markdown file, the second button will appear, it will render and let you download result file.

The result file will have same name with upload file. In the example, format used pptx.

There’s additional buttons in Right Top. Each shows Homepage, Version of showmaker and User manual.

5. Result (HTML)

6. Guide to ChatGPT (or Other AI)

You can ask to ChatGPT to build Slide-markdown with below prompt.

If you think you have better prompt, your contribute is welcome.

Please make markdown file explaining <TOPIC>, to build slide with this instruction.

1. Markdown should include header to rendered by Quarto: 
`title`, `author`, `format: revealjs`, `embed-resource:true`

For example, 

---
title: "쇼메(Showmaker) 데모"
author: "showmaker"
format: revealjs
embed-resources: true
---

2. Each page should divided by #

For example,

# 소개

- **쇼메**는 Markdown 파일을 Quarto를 통해 슬라이드로 변환합니다.
- Rust + Tauri 기반 데스크톱 앱입니다.
- 간단한 CLI나 UI에서 사용 가능합니다.

# 주요 기능

1. Markdown 입력 → Quarto 슬라이드 변환
2. 테마 선택 가능
3. PDF, HTML로 내보내기 지원