# 마크다운 치트 시트

This Markdown cheatsheet is intended as a quick reference and showcase of the Markdown syntax in QOwnNotes.

## 제목

Use ATX headings to structure your texts.

```markdown
# H1

## H2

### H3

#### H4

##### H5

###### H6
```

::: tip
**네비게이션 패널**은 제목의 구조를 보여줍니다.
:::

Alternatively, for H1 and H2, you can also use Setext headings:

```markdown
Alt-H1
======

Alt-H2
------
```

::: tip
기본적으로 QOwnNotes는 **머리글 1** (h1)에서 **노트의 파일 이름**을 작성합니다.
:::

## 강조

```markdown
강조, 즉 기울임꼴는 *별표* 또는 _밑줄_과 함께 사용됩니다.

강하게 강조하려면 **별표** 또는 __밑줄__을 사용하세요.

**별표와 밑줄**을 함께 사용하여 강조합니다.
```

[단축키](./shortcuts.md) <kbd>Ctrl + B</kbd>를 사용하여 텍스트를 굵게 표시하고 <kbd>Ctrl + I</kbd>을 사용하여 기울임꼴로 표시할 수 있습니다.
:::

## 밑줄

_미리보기 설정_에서 밑줄 렌더링을 활성화하는 옵션 설정도 있습니다.

```markdown
_밑줄_
```

::: tip
[단축키](./shortcuts.md) <kbd>Ctrl + U</kbd>를 사용하여 텍스트에 밑줄을 표시할 수 있습니다.
:::

## 취소선

```markdown
~~취소선~~
```

::: tip
[단축키](./shortcuts.md) <kbd>Alt + Shift + S</kbd>을 사용하여 텍스트를 삭제할 수 있습니다.
:::

## 목록

목록을 만드는 방법은 여러 가지가 있습니다.

```markdown
1. 첫 번째 정렬된 목록 항목
2. 다른 항목

- 정렬되지 않은 하위 목록입니다.

1. 실제 숫자는 중요하지 않습니다. 단지 숫자일 뿐입니다
1. 그리고 또 다른 항목입니다.

* 순서 없는 목록에는 별표를 사용할 수 있습니다.

- 또는 빼기 기호

+ 또는 더하기 기호
```

::: tip
목록 끝에 있는 <kbd>Enter을 누르면 새 목록 항목이 생성됩니다. :::</p>

<h2 spaces-before="0">
  링크
</h2>

<p spaces-before="0">
  링크를 쉽게 사용할 수 있는 두 가지 방법은 웹 페이지나 기타 노트를 가리킵니다. 이러한 링크는 여러 가지 방법으로 볼 수 있습니다.
</p>

<h3 spaces-before="0">
  외부 링크
</h3>

<pre><code class="markdown">[저는 인라인 스타일 링크입니다](https://www.google.com)

[저는 제목이 있는 인라인 스타일 링크입니다](https://www.google.com "Google's Homepage")

[참조 스타일 링크 정의에 숫자를 사용할 수 있습니다][1]

각 괄호 안의 일반 URL과 URL은 미리보기에서 자동으로 링크로 바뀝니다.
http://www.example.com 또는 &lt;http://www.example.com&gt;

[1]: https://www.qownnotes.org
</pre>

<h3 spaces-before="0">
  내부 링크
</h3>

<p spaces-before="0">
  다음과 같은 다른 노트나 첨부 파일에 연결할 수 있습니다:
</p>

<pre><code class="markdown">[Journal.md 노트에 링크합니다] (Journal.md)
&lt;Journal.md&gt; 비슷하게 작동합니다.
</pre>

<p spaces-before="0">
  ::: 팁 [단축키](./shortcuts.md) <kbd>Ctrl + L</kbd>을 사용하여 웹 페이지 또는 <strong x-id="1">기타 노트에 대한 링크를 만들 수 있습니다</strong>.
</p>

<p spaces-before="0">
  <kbd>Ctrl + Shift + X</kbd>를 사용하면 노트에 <strong x-id="1">첨부 파일을 삽입</strong>하는 데 도움이 되는 대화 상자가 나타납니다.
</p>

<p spaces-before="0">
  노트의 링크에서 커서를 편집하여 링크를 따라가는 동안 <kbd>Ctrl + Space</kbd>를 누를 수 있습니다.
:::
</p>

<p spaces-before="0">
  ::: 경고 정보 제목이 있는 내부 링크는 지원되지 않습니다:
</p>

<pre><code class="markdown">[Journal.md 노트에 링크합니다](Journal.md "제목 지원되지 않음")
</pre>

<p spaces-before="0">
 
:::
</p>

<h3 spaces-before="0">
  북마크
</h3>

<p spaces-before="0">
  [QOwnNotes Web Companion 브라우저 확장](./browser-extension.md)에서 사용되는 북마크는 목록의 연결을 사용합니다.
</p>

<pre><code class="markdown">- [웹페이지 이름](https://www.example.com) #tag1 #tag2 일부 설명 및 태그
</pre>

<h2 spaces-before="0">
  이미지
</h2>

<p spaces-before="0">
  이미지를 QOwnNotes에 포함할 수 있습니다. 미리보기에 표시됩니다.
</p>

<pre><code class="markdown">![alt text](media/my-image.jpg)
</pre>

<h3 spaces-before="0">
  이미지 치수
</h3>

<p spaces-before="0">
  닫힘 괄호 바로 뒤에 컬리 브레이스 속성 구문을 사용하여 이미지의 ` 너비` 및/또는 ` 높이`을 선택적으로 지정할 수 있습니다:
</p>

<pre><code class="markdown">![alt text](media/my-image.jpg){ width=300 }

![alt text](media/my-image.jpg){ height=200 }

![alt text](media/my-image.jpg){ width=300 height=200 }
</pre>

<p spaces-before="0">
  치수 속성은 편집기에서 마스킹된 (회색 처리된) 구문으로 표시되며, 자동 이미지 너비 크기보다 우선시되는 미리보기에 적용됩니다.
</p>

<p spaces-before="0">
  ::: 팁 [단축키](./shortcuts.md) <kbd>Ctrl + Shift + I</kbd> 를 사용하여 노트에 이미지를 삽입할 수 있습니다. 이미지가 클립보드에 있을 수도 있으며 대화상자가 이미지를 감지하고 미리보기를 표시합니다.
</p>

<p spaces-before="0">
  <kbd>Ctrl + Shift + V</kbd>을 사용하여 클립보드의 이미지를 노트에 직접 붙여넣을 수도 있습니다.
:::
</p>

<p spaces-before="0">
  ::: 경고 정보 제목이 있는 이미지 링크는 지원되지 않습니다:
</p>

<pre><code class="markdown">![alt text](media/my-image.jpg "제목 지원되지 않음")
</pre>

<p spaces-before="0">
 
:::
</p>

<h2 spaces-before="0">
  인라인 코드 및 코드 블록
</h2>

<pre><code class="markdown">인라인 '코드' 주위에 '백틱'이 있습니다.
</pre>

<p spaces-before="0">
  ::: 팁 선택한 인라인 텍스트 또는 텍스트 바로 안쪽에서 [단축키](./shortcuts.md) <kbd>Ctrl + Shift + C</kbd>를 사용하여 인라인 코드 블록을 만들 수 있습니다.
:::
</p>

<p spaces-before="0">
  코드 블록은 세 개의 백 틱이 있는 선으로 울타리를 두르거나 네 개의 공백으로 들여씁니다.
</p>

<h3 spaces-before="0">
  4-공간 울타리
</h3>

<p spaces-before="0">
  코드 앞에 공백 4개를 추가하여 코드 블록으로 표시합니다.
</p>

<pre><code class="markdown">    s = "공백 들여쓰기 코드"
    print s
</pre>

<h3 spaces-before="0">
  백틱 울타리
</h3>

<p spaces-before="0">
  세 개의 백틱을 사용하여 코드 블록을 만들 수도 있습니다.
</p>

<p spaces-before="0">
  ````마크다운
</p>

<pre>코드는 여기에 있습니다
코드는 여기에 있습니다
</pre>

<pre>
::: tip

 [shortcut](./shortcuts.md) &lt;kbd>Ctrl + Shift + C&lt;/kbd>를 선택한
 여러 텍스트 행 또는 빈 행에서 사용하여 코드 블록을 만들 수 있습니다.
:::

### 코드 강조 표시가 있는 백틱 울타리

QOwnNotes에는 코드 블록을 사용하여 구문을 강조 표시하는 기능도 있습니다.

````markdown
```bash
# I am a comment
cd Notes
</pre>

<pre>
현재 지원되는 언어 (및 코드 블록 식별자)는 다음과 같습니다:

- BASh scripting, `bash`
- C, `c`
- C++, `cpp`
- C++, `cxx`
- C++, `c++`
- C#, `c#`
- CMake, `cmake`
- C#, `csharp`
- CSS, `css`
- Go, `go`
- HTML, `html`
- INI, `ini`
- Java, `java`
- JavaScript, `javascript`
- JavaScript, `js`
- JSON, `json`
- Makefile, `make`
- PHP, `php`
- Python, `py`
- Python, `python`
- QML, `qml`
- Rust, `rust`
- Shell scripting, `sh`
- SQL, `sql`
- TypeScript, `ts`
- TypeScript, `typescript`
- V, `v`
- Vex, `vex`
- XML, `xml`
- YAML, `yml`
- YAML, `yaml`

## 테이블

```마크다운
콜론은 열을 정렬하는 데 사용할 수 있습니다.

| 테이블        | 이           | 멎져요  |
| ------------- | :-----------: | ----: |
| 열 3 은      | 오른쪽 정렬 | $1600 |
| 열 2 는      | 가운데      |   $12 |
| 얼룩말 줄무늬는 | 깔끔해요      |    $1 |

각 머리말 셀을 구분하는 대시가 3개 이상 있어야 합니다.

인라인 마크다운을 사용할 수도 있습니다.

| Markdown | Less      | Pretty     |
| -------- | --------- | ---------- |
| _Still_  | `renders` | **nicely** |
| 1        | 2         | 3          |
</pre>

<p spaces-before="0">
  ::: 팁 <kbd>Alt + Shift + T</kbd>을 눌러 표 작성에 도움이 되는 대화상자를 활성화합니다. 이 대화 상자에서 CSV 파일을 가져올 수도 있습니다.
</p>

<p spaces-before="0">
  Use <kbd>Ctrl + Space</kbd> inside a Markdown table to automatically format it.
:::
</p>

<h2 spaces-before="0">
  블럭 따옴표
</h2>

<pre><code class="markdown">&gt; 이메일에서 블록 따옴표는 회신 텍스트를 에뮬레이트하는 데 매우 유용합니다.
&gt; 이 줄은 같은 인용구의 일부입니다.

따옴표로 묶습니다.

&gt; 줄 바꿈이 끝날 때도 여전히 적절하게 따옴표로 묶일 수 있는 매우 긴 줄입니다. 모든 사람이 실제로 감싸기에 충분한 길이인지 확인하기 위해 계속 작성해 보겠습니다. 오, 블록 인용문에 **마크다운**을 넣을 수 있습니다.
</pre>

<p spaces-before="0">
  ::: 팁 QOwnNotes에게 블록 따옴표를 완전히 강조 표시하거나 <em x-id="4">편집기 설정</em>에서 블록 따옴표 문자만 강조 표시하도록 지시할 수 있습니다
</p>

<p spaces-before="0">
  [단축키](./shortcuts.md) <kbd> Ctrl + Shift + B</kbd>을 사용하여 텍스트를 블록 따옴표로 표시할 수 있습니다.
:::
</p>

<h2 spaces-before="0">
  수평 규칙
</h2>

<p spaces-before="0">
  수평 규칙을 얻는 세 가지 방법이 있습니다: 하이픈, 별표 또는 밑줄을 사용할 수 있습니다.
</p>

<pre><code class="markdown">3개 이상...

하이픈

---

별표

***

밑줄

___
</pre>

<h2 spaces-before="0">
  줄 바꿈
</h2>

<ul>
  <li>
    문단을 하나 이상의 행으로 분할하여 편집할 수 있지만, 문단은 계속해서 중단 없이 단일 문단으로 렌더링됩니다.
  </li>
  <li>
    두 개의 공백으로 선을 종료하여 문단 내부에서 줄 바꿈을 수행할 수 있습니다.
  </li>
  <li>
    빈 줄로 구분하여 별도의 단락을 만들 수 있습니다.
  </li>
</ul>

<p spaces-before="0">
  ::: 팁 <kbd>⇧ Shift</kbd> + <kbd>Return</kbd>으로 공백 2개와 줄 바꿈을 입력할 수 있습니다.
:::
</p>

<pre><code class="markdown">여기부터 시작할 수 있는 줄이 있습니다.

이 선은 위의 선과 두 개의 새로운 선으로 분리되어 있으므로 _분리된 문단_이 될 것입니다.

이 줄도 별도의 단락으로 시작하지만... 
이 선은 두 개의 후행 공간과 하나의 새로운 선으로만 분리되어 있으므로 _같은 문단_에서 별도의 선입니다.
</pre>

<p spaces-before="0">
  ::: 팁
후행 공백은 편집기에서 기본적으로 강조 표시됩니다.
:::
</p>

<h2 spaces-before="0">
  주석
</h2>

<p spaces-before="0">
  설명은 미리보기에 표시되지 않습니다.
</p>

<pre><code class="markdown">[comment]: # "이 주삭은 미리보기에 나타나지 않습니다"

&lt;!-- HTML 주석도 숨겨져 있습니다 --&gt;
</pre>

<p spaces-before="0">
  ::: 팁
노트의 선행 html 주석 블록은 자동 노트 파일 이름 생성에서도 무시됩니다.
:::
</p>

<h2 spaces-before="0">
  확인란 목록
</h2>

<p spaces-before="0">
  확인란 목록을 사용하여 간단한 작업관리 목록을 작성할 수 있습니다.
</p>

<pre><code class="markdown">- [x] 완료
- [ ] 할 일
</pre>

<p spaces-before="0">
  ::: 팁
미리보기에서 확인란을 선택하거나 선택 취소할 수 있습니다.
:::
</p>

<h2 spaces-before="0">
  전문
</h2>

<p spaces-before="0">
  QOwnNotes에서 전문 (예: YAML)을 사용하여 추가 메타 정보를 추가할 수 있습니다. <strong x-id="1">미리보기에 표시되지 않으며</strong> <strong x-id="1">자동 노트 파일 이름 생성을 방해하지 않습니다</strong>.
</p>

<pre><code class="markdown">---
제목: 일부 이름
description: 일부 설명
---

# 노트 헤드라인이 여기에서 시작됩니다

일부 텍스트
</pre>

<p spaces-before="0">
  이 예제 노트의 파일 이름은 `Note headline starts here.md`입니다.
</p>
