¿Cómo mostrar contenido HTML en github README.md?

83

Soy nuevo en github, README.mdquiero mostrar un contenido HTML usando un Iframe o algo, ¿es posible?

Lo que he intentado es que solo creo etiquetas HTML que no sean el ancla, eso no funciona.

BalaKrishnan 웃
fuente
Otras sugerencias en la pregunta duplicada: stackoverflow.com/questions/48402823/…
ms609

Respuestas:

47

El intérprete de rebajas de Github puede incluir HTML. Sin embargo, hay mucho que puede hacer en HTML. Sugeriría consultar este artículo que proporciona más información sobre qué etiquetas se pueden usar. Personalmente, nunca he usado mucho más que saltos de línea, reglas horizontales, etc. Desafortunadamente, no veo los Iframes mencionados en el artículo.

mjgpy3
fuente
14
Eliminan agresivamente los html que podrían ser perjudiciales para los usuarios, como los scripts. Un iframe entraría en esa categoría porque potencialmente podría servir cualquier cosa a las personas, incluso malware allí mismo en github.
s1h4d0w
38

Como respondió mjgpy3 , puede incluir html; no se <html>necesitan etiquetas, pero se desinfectará antes de mostrarse y las únicas etiquetas permitidas están en esta lista blanca .

La lista incluye actualmente:

h1 h2 h3 h4 h5 h6 h7 h8 br b i strong em a pre code img tt div ins del sup sub p ol ul table thead tbody tfoot blockquote dl dt dd kbd q samp var hr ruby rt rp li tr td th s strike summary details caption figure figcaption abbr bdo cite dfn mark small span time wbr

pero ninguna iframe.

lazysoundsystem
fuente
1
La lista publicada de lazysoundsystem cambió. Consulte la línea # 46, 47, 48 para ver las ETIQUETAS HTML PERMITIDAS: GitHub-HTML-pipeline-sanitization_filter.rb , verifiqué + encontré que el enlace es correcto, en este momento. Tales ETIQUETAS no permitidas: script, estilo, iframe, span,… Pero div, table,… parcialmente permitido. GitHub también elimina / filtra muchos Atributos usados ​​dentro de TAG. Como GitHub puede aplicar Filtro en TAGs y Attrib (s), deberían permitir <style>, <script>,… con Filtering-ON, para permitir al menos algunas propiedades / comandos CSS + JS seguros.
atErik
1

Puede usar svg para solucionar el código de ejemplo (./path/example.svg):

<svg width="100" height="100" xmlns="http://www.w3.org/2000/svg">
<foreignObject width="100" height="100">
    <div xmlns="http://www.w3.org/1999/xhtml">
        <ul>
            <li>text</li>
        </ul>
        <!-- Other embed HTML element/text into SVG -->
    </div>
</foreignObject>
</svg>

y luego use la forma de inserción de imagen para incrustar el archivo svg en cualquier otro archivo de rebajas, como este:

![](./path/example.svg)
yihao ye
fuente