Markdown to format pisma. HTML to format publikowania. W związku z tym składnia języka Markdown nie zapewnia pełnej uniwersalności języka HTML, a jedynie typowe elementy tekstu pisanego. Jeśli chcesz zrobić coś bardziej skomplikowanego, możesz użyć dowolnego wbudowanego tagu HTML lub tagów na poziomie bloku, które są obsługiwane przez DevSite w pliku Markdown. Nie musisz wskazywać, że przechodzisz z formatu Markdown na HTML. Wystarczy, że użyjesz tagu HTML zgodnie z poniższym przykładem.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Wbudowany kod HTML
Wbudowane tagi HTML mogą być używane w akapicie, elemencie listy lub nagłówku Markdown.Mogą też zawierać składnię języka Markdown (np. **strong**, *emphasis* itp.) Jest to przydatne, gdy chcesz zwrócić uwagę na fragment kodu, tak jak w poniższym przykładzie.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
Kod HTML na poziomie bloku
Tagi HTML na poziomie bloku, które są obsługiwane przez DevSite, muszą być oddzielone od otaczającej je treści pustym wierszem. W odróżnieniu od wbudowanych tagów HTML składnia języka Markdown (np. **strong**, *emphasis* itp.) w tagach HTML na poziomie bloku nie są renderowane, jak w poniższym przykładzie.
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.
Sprawdzone metody
Zalecamy formatowanie HTML w plikach Markdown w następujący sposób, aby zapobiec błędom renderowania w DevSite.
Nie używaj nieobsługiwanych tagów HTML na poziomie bloku DevSite obsługuje wiele tagów HTML na poziomie bloku. ale dołączenie nieobsługiwanego spowoduje wyrenderowanie kodu HTML jako tekst lub uszkodzenie kodu.
Nie dodawaj dodatkowych znaków tabulacji ani spacji podczas wprowadzania wcięć. Tagów początkowych i końcowych na poziomie bloku nie należy dodawać znaków tabulacji ani spacji. Niektóre edytory automatycznie dodają dodatkowe tabulatory lub spacje – uwaga!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Pamiętaj, że kod bez wcięcia jest względny
Dzięki temu nie musisz na przykład dodawać wcięć do tagów początkowych i końcowych na poziomie bloku podczas tworzenia list w 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
Nie dodawaj pustego wiersza między tagiem początkowym i końcowym
To proste podczas przełączania się między formatami Markdown i HTML, ale prosty pusty wiersz może sprawić, że strona będzie niepoprawnie renderowana.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.