마크다운은 쓰기 형식입니다. HTML은 게시 형식입니다. 따라서 마크다운 구문은 작성된 텍스트에 가장 일반적인 요소인 HTML의 다양한 기능을 제공하기 위한 것이 아닙니다. 더 복잡한 작업이 필요한 경우 마크다운 파일에서 DevSite가 지원하는 모든 인라인 HTML 태그 및 블록 수준 태그를 사용할 수 있습니다. 마크다운에서 HTML로 전환 중임을 표시할 필요는 없습니다. 아래 예와 같이 HTML 태그를 사용하면 됩니다.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
인라인 HTML
인라인 HTML 태그는 마크다운 단락, 목록 항목 또는 헤더 내에서 사용할 수 있으며 마크다운 구문 (예: **strong**, *emphasis* 등) 이 기능은 아래 예와 같이 일부 코드에 주의를 끌려고 할 때 유용합니다.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
블록 수준 HTML
DevSite에서 지원하는 블록 수준 HTML 태그는 빈 줄로 주변 콘텐츠와 구분되어야 합니다. 인라인 HTML 태그와 달리 마크다운 구문 (예: **strong**, *emphasis* 등)은 아래 예와 같이 렌더링되지 않습니다.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
권장사항
DevSite에서 렌더링 오류를 방지하려면 다음과 같은 방법으로 마크다운 파일의 HTML 형식을 지정하는 것이 좋습니다.
지원되지 않는 블록 수준 HTML 태그를 사용하지 마세요. DevSite는 많은 블록 수준 HTML 태그를 지원합니다. 지원되지 않는 URL을 포함하면 HTML이 텍스트로 렌더링되거나 코드가 깨집니다.
들여쓰기할 때 불필요한 탭이나 공백을 추가하지 않음 블록 수준의 시작 및 종료 태그를 탭이나 공백으로 들여쓰기해서는 안 됩니다. 일부 편집기는 자동으로 탭이나 공백을 추가하므로 주의하세요.
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
들여쓰기가 해제된 코드는 상대적인 코드라는 것을 기억하세요.
예를 들어 마크다운에서 목록을 만들 때 블록 수준 시작 태그와 종료 태그를 들여쓰기할 필요가 없습니다.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
시작 태그와 종료 태그 사이에 빈 줄을 추가하지 마세요.
이는 마크다운과 HTML 간에 전환할 때 쉽게 수행할 수 있지만 빈 줄만 사용하면 페이지를 잘못 렌더링할 수 있습니다.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.