마크다운 markdown 작성

마크다운이란

텍스트 기반의 마크업언어로 2004년 존그루버에 의해 만들어졌으며 쉽게 쓰고 읽을 수 있으며 HTML로 변환이 가능하다. 특수기호와 문자를 이용한 매우 간단한 구조의 문법을 사용해 웹에서도 보다 빠르게 컨텐츠를 작성하고 보다 직관적으로 인식할 수 있다. 마크다운이 최근 각광받기 시작한 이유는 깃허브때문인데 깃허브 저장소 repository에 관한 정보를 기록하는 README.md는 가장 먼저 접하게 되는 문서다. 마크다운을 통해서 설치방법, 소스코드 설명, 이슈 등을 간단하게 기록하고 가독성을 높인다.

 

장점

• 간결성
• 별도 도구없이 작성가능
• 다양한 형태 변환 가능
• 텍스트로 저장되어 용량이 적음
• 텍스트파일로 버전관리시스템 이용 변경이력을 관리할 수 있음
• 지원하는 프로그램과 플랫폼이 다양함

 

단점

• 표준 부재
• 도구에 따라 변환방식과 생성물이 다름
• 모든 HTML 마크업을 대신하지 못함

 

사용법(문법)

1. 헤더

큰제목

This is an H1
=============

작은제목

This is an H2
-------------

글머리(1~6까지만지원)

# This is a H1
## This is a H2
### This is a H3
#### This is a H4
##### This is a H5
###### This is a H6

2.BlockQuote

이메일에서 사용하는 > 블럭인용문자를 이용

> This is a first blockqute.
>	> This is a second blockqute.
>	>	> This is a third blockqute.

이 안에서는 다른 마크다운 요소를 포함할 수 있다.

This is a H3

• List

  code

3.목록

순서있는 목록(번호)

1. 첫번째
2. 두번째
3. 세번째

순서없는 목록 (글머리 기호 *,+,- 지원)

(입력)

* 빨강
  * 녹색
    * 파랑

+ 빨강
  + 녹색
    + 파랑

- 빨강
  - 녹색
    - 파랑

(출력)

• 빨강
  • 녹색
    • 파랑

• 빨강
  • 녹색
    • 파랑

• 빨강
  • 녹색
    • 파랑

4.코드

• <pre><code>{code}</code></pre> 이용방식

<pre>
<code>
public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }

}
</code>
</pre>

public class BootSpringBootApplication {
  public static void main(String[] args) {
    System.out.println("Hello, Honeymon");
  }
}

• 코드블럭코드("```") 을 이용하는 방법

5.수평선

* * *

***

*****

- - -

---------------------------------------

6.링크

• 참조링크

[link keyword][id]

[id]: URL "Optional Title here"

// code
Link: [Google][googlelink]

[googlelink]: https://google.com "Go google"

• 외부링크

사용문법: [Title](link)
적용예: [Google](https://google.com, "google link")

• 자동연결

일반적인 URL 혹은 이메일주소인 경우 적절한 형식으로 링크를 형성한다.

* 외부링크: <http://example.com/>
* 이메일링크: <address@example.com></address@example.com>

7.강조

*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
~~cancelline~~

8.이미지

![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")

사이즈 조절 기능은 없어서  <img width="" height=""></img> 이용

<img src="/path/to/img.jpg" width="450px" height="300px" title="px(픽셀) 크기 설정" alt="RubberDuck"></img><br/>
<img src="/path/to/img.jpg" width="40%" height="30%" title="px(픽셀) 크기 설정" alt="RubberDuck"></img>

9.줄바꿈

* 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다. 
이렇게

* 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다.___\\ 띄어쓰기
이렇게

• 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다. 이렇게
• 줄 바꿈을 하기 위해서는 문장 마지막에서 3칸이상을 띄어쓰기해야 한다.
  이렇게

정리

마크다운은 기본문법만 알고 있다면 텍스트편집기에서도 쉽게 작성이 가능한 언어이며 점점 널리 사용되고 있다.

Dropbox 프로를 구매해서 집-탭탑-스마트폰이 각각 연동을 시켜 사용할 수 있고 드랍박사에 저장된 마크다운 문서는 dropbox 웹서비스 상에서 제공하기 때문에 웹상에서 바로 열람 할 수 도 있어 링크를 걸어 다른 사람과 공유하는 형식으로 가능하다.

그리고

Notion에서 작성한 문서는 Atom, Visual Studio Code, Notepad 텍스트 편집기에 복붙하면 마크다운문법으로 작성된 문장이 기입되고 이지웍 에디터를 제공하는 웹에디터에 붙여넣기 하면 완벽한 형태로 복사된다.