Including HTML in Markdown

Refresh

1 weeks ago

Views

711 time

1

Assuming I am in control of the parsing environment and I'm certain it is only to be converted to HTML (and not any of the many other formats possible); is it ok to embed some HTML within one's Markdown, in order to side-step around a bug?
Could there be any basic sideffects I (as a newbie) couldn't predict but should be aware of?

Non-conventional Markdown example:
_"<strong>This</strong> is an example sentence."_ -**OP**
Which outputs valid HTML:
<em>"<strong>This</strong> is an example sentence."</em> -<strong>OP</strong>
Resulting in successful content:

"This is an example sentence." -OP


Background (don't have to read):

I noticed that if I include HTML in my Markdown, it appears to get skipped during the conversion, resulting in it being seamlessly incorporated in the output HTML.
This appears to be a good thing, at least in my case (Using Hugo to build a website with a template theme) where the Markdown wasn't producing the correct result (leaving a pair of unwanted *s in the HTML: should have been *italic* but asterisks showing).
For those wondering - yes, I confirmed my Markdown was correct using other parsers that handled it fine.

Note: the examples here are simplifications of my specific case

2 answers

4

Мало того, что это хорошо сделать, но приветствуется. Как правила государства:

Для любой разметки, не охватывается синтаксис Markdown, вы просто использовать сам HTML. Там нет необходимости предварить его или разграничить его, чтобы указать, что вы переходите от Markdown к HTML; Вы просто использовать тег.

И позже:

Если вы хотите, вы даже можете использовать HTML - теги вместо Markdown форматирования; например , если вы предпочитаете использовать HTML <a>или <img>тэги вместо ссылки или изображения синтаксиса Markdown, перейдите прямо вперед.

Конечно, есть несколько вещей, чтобы принять во внимание. Для тегов уровня примера блока должны быть на уровне корневого документа (не может быть вложены в списки блоков цитат, и т.д.) и содержание в них не получают разобрано как Markdown. Однако встроенные теги могут быть размещены в любом месте и не ограничивают Markdown разбора.

0

Для людей , использующих Markdown в модульной или пользователем гибкой среды (вероятно , чуть более продвинутых читателей):
Следует отметить , что , хотя Markdown наиболее часто преобразуется в HTML, он также может быть использован с другими форматами [1] .
По этой причине я считаю , что это важно , чтобы подтвердить , что если вы (как издатель контента) не тот , кто определяет , что Markdown будет анализироваться с, или , как он преобразуется это может быть «безопаснее» , чтобы не вставлять HTML в нем ,

[1] , как указано в странице Markdown Википедии .