- 3.4. Składnia pliku
3.4.14. Wstawki HTML - 3.4.13. Bloki cytatu i ramki informacyjne
« Poprzedni - 3.4.15. Zaawansowane użycie
Następny »
3.4.14. Wstawki HTML
Jeśli składnia Markdowna nie wystarcza do osiągnięcia zamierzonego efektu, można bez problemu korzystać ze znaczników HTML, bezpośrednio w tekście. Nie trzeba stosować żadnej specjalnej składni, przełączników - po prostu używasz znaczników.
Jedynym ograniczeniem jest to, że HTML-owe znaczniki blokowe - takie jak: <div>, <table>, <pre>, <p> itd. - muszą być oddzielone pustą linijką od pozostałego tekstu i muszą zaczynać się bezpośrednio od krawędzi - nie mogą być poprzedzone tabulacjami lub spacjami. Parser jest na tyle sprytny, że nie otoczy wtedy HTML-a znacznikami akapitu.
Jeśli np. potrzeba było wstawić bardziej rozbudowaną tabelkę można po prostu napisać:
To jest normalny akapit
<table>
<tr>
<td>Coś</td>
</tr>
</table>
To jest kolejny normalny akapit.
W takim jednak przypadku, składnia Markdown nie jest w znacznikach parsowana. Trzeba więc używać np. <strong> zamiast **wyróżnienia**.
Znaczniki liniowe - jak: <span>, <del>, <sup> - mogą być użyte gdziekolwiek w akapitach, listach, nagłówkach. Ba, możesz normalnie zamienić znacznikami HTML składnię Markdown, np. jeśli wolisz używać znaczników <a> lub <img> zamiast odnośników i obrazków.
W znacznikach liniowych - w przeciwieństwie do blokowych - składnia Markdown jest parsowana.
Formatowanie Markdown w elementach blokowych
Originalna składnia Markdown wyklucza parsowanie składni w HTML-owych znacznikach blokowych. Została jednak rozszerzona o możliwość opcjonalnego włączenia tego parsowania poprzez dopisanie do znacznika atrybutu markdown o wartości 1, co daje markdown="1":
<div markdown="1">
To jest *prawdziwy* tekst Markdownowy.
</div>
Co wygeneruje:
<div>
<p>To jest <em>prawdziwy</em> tekst Markdownowy.</p>
</div>
Parser jest bardzo sprytny i prawidłowo zachowuje się do różnych znaczników. Jeśli np. włączysz formatowanie dla znaczników <p>, spowoduje to sformatowanie jedynie elementów liniowych, nie dopuszczając list, bloków cytatu itd.
Są jednak sytuacje, gdy jest to niejednoznaczne. Spójrzmy na przykład:
<table>
<tr>
<td markdown="1">To jest *prawdziwy* tekst Markdownowy.</td>
</tr>
</table>
Komórka tabeli może przyjmować i elementy liniowe, i elementy blokowe. W takich jak ta sytuacjach Markdown zawsze włącza parsowanie jedynie elementów liniowych. Gdy potrzebujesz włączyć składnię blokową, zmień wartość atrybutu na markdown="block".
3.4.14. Wstawki HTML
3.4. Składnia pliku- « Poprzedni
3.4.13. Bloki cytatu i ramki informacyjne - Następny »
3.4.15. Zaawansowane użycie