Descargo de responsabilidad: Este artículo se generó mediante traducción automática.

¿Cómo agregar acordeón en Markdown?

Prev Next

Planes que admiten la personalización de texto en el editor de Markdown

Plans supporting this feature: Professional Business Enterprise

Si desea que su contenido aparezca como un acordeón en los artículos basados en el editor de Markdown, no hay opción para agregarlo usando una herramienta convencional de la barra de menú o una sintaxis sencilla de Markdown.

Utilice la siguiente solución alternativa para agregar un acordeón sin esfuerzo en el editor de Markdown.

Solución

  1. Ve al artículo deseado y ábrelo en el editor de Markdown.

  2. Pegue el siguiente código en la ubicación deseada donde desea que aparezca el acordeón

<details>
    <summary>Accordion_name</summary>
    <p>Accordion_content</p>
    </details>
  1. Reemplace el Accordion_name texto con el título/nombre de acordeón deseado

  2. Reemplace el Accordion_content texto con el contenido deseado

Si desea agregar encabezados dentro del acordeón, puede usar las etiquetas HTML de encabezado (<h2>..</h2>, <h3>..</h3>, <h4>..</h4>) en las Accordion_content secciones

CAUTELA

Las etiquetas de encabezado se pueden usar en la sección de resumen del acordeón "Accordion_name", pero la alineación del texto puede verse afectada.

Ejemplo

Código

<details>
    <summary><strong>What is Document360?</strong></summary>
    <p>A well-structured product to create a world-class knowledge base for your customers and employees. Content producers get the power, whereas content consumers get the simplicity.</p>
    <h4>Core parts</h4>
    <ul>
        <li>Knowledge base portal</li>
        <li>Knowledge base site</li>
        <li>Knowledge base widget</li>
        <li>API documentation</li>
    </ul>
</details>

Resultado

¿Qué es Document360?

Un producto bien estructurado para crear una base de conocimientos de clase mundial para sus clientes y empleados. Los productores de contenido obtienen el poder, mientras que los consumidores de contenido obtienen la simplicidad.

Piezas principales

  • Portal de la base de conocimientos

  • Sitio de la base de conocimientos

  • Widget de la base de conocimientos

  • Documentación de la API


Personalizaciones avanzadas para acordeones

Puede mejorar el acordeón agregando colores, bordes punteados e íconos, y configurándolo para que siempre esté abierto. A continuación, se explica cómo aplicar estas personalizaciones:

Adición de color de encabezado al acordeón

Para agregar color de encabezado al acordeón en los artículos, siga los pasos a continuación:

  1. Vaya a Configuración () > sitio de la base de conocimientos > Personalizar sitio > CSS y JavaScript personalizados en el portal de la base de conocimientos.

  2. En el panel de navegación izquierdo, haga clic en la pestaña CSS y pegue el siguiente fragmento de CSS:

.details-wrapper details[open] summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0rem 0rem !important;
}
.details-wrapper summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0.75rem 0.75rem !important;
}
.details-wrapper details:not([open]) summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0.75rem 0.75rem !important;
}
  1. Haga clic en Guardar.


Aplicación de un color de borde y líneas punteadas

Para aplicar un color de borde y líneas punteadas al pasar el puntero:

  1. Vaya a Configuración () > sitio de la base de conocimientos > Personalizar sitio > CSS y JavaScript personalizados en el portal de la base de conocimientos.

  2. En el panel de navegación izquierdo, haga clic en la pestaña CSS y pegue el siguiente fragmento de CSS:

.details-arrow {
    left: 16px !important;
    top: 42% !important;
    transition: revert;
    transform: rotate(317deg);
}
.details-wrapper details {
    border: 1px dotted var(--e360-base-light-gray) !important;
    transition: border 0.3s ease;
}
.details-wrapper details: hover {
    border: 1px solid var(--e360-base-light-gray) !important;
}
.details-wrapper_rendered summary {
    left: 19px;
    position: relative;
}
.details-wrapper details[open]+.details-arrow {
    transform: rotate(45deg);
}
  1. Personalice el código anterior en función de sus necesidades.

  2. Una vez hecho esto, haga clic en Guardar.


Configurar un acordeón para que siempre esté abierto

Para mantener un acordeón siempre abierto, modifique el open atributo directamente en el HTML:

<details open>
    <summary>Always Open Accordion</summary>
    <p>Content remains visible without user interaction.</p>
</details>

Esto garantiza que el contenido sea visible de forma predeterminada.


Adición de un icono más al encabezado del acordeón

Para agregar un icono más que gira al abrirlo:

  1. Vaya a Configuración () > sitio de la base de conocimientos > Personalizar sitio > CSS y JavaScript personalizados en el portal de la base de conocimientos.

  2. En el panel de navegación izquierdo, haga clic en la pestaña CSS y pegue el siguiente fragmento de CSS:

    .details-wrapper details summary::before {
        content: "+";
        display: inline-block;
        margin-right: 10px;
        transition: transform 0.3s ease;
    }
    .details-wrapper details[open] summary::before {
        content: "-";
        transform: rotate(45deg);
    }
  3. Ajusta los iconos o las transiciones como prefieras.

  4. Haga clic en Guardar.


Preguntas frecuentes

¿Puedo diseñar un acordeón usando solo Markdown?

Markdown por sí solo no admite estilos avanzados o interactividad como los que encontraría con HTML y CSS. Sin embargo, puede lograr un efecto de acordeón simple utilizando las funciones integradas de Markdown, particularmente con plataformas que lo admiten, como Document360.

¿Cuáles son las limitaciones de usar Markdown para acordeones?

  • Compatibilidad con navegadores: Los <details> elementos y <summary> funcionan en la mayoría de los navegadores modernos, pero es posible que no se representen correctamente en todos los entornos de Markdown.

  • Styling: No podrá aplicar estilo al acordeón (por ejemplo, colores, bordes) más allá de los estilos predeterminados del navegador.

  • Interactividad: La interactividad se limita a colapsar y expandir el texto sin animaciones adicionales ni opciones de diseño.

¿Cómo puedo crear un acordeón usando Markdown?

El uso de las <details> etiquetas y <summary> dentro de Markdown es la mejor manera de crear un acordeón básico sin CSS o JavaScript adicional. Para mejorar el estilo o las funciones, deberá recurrir a HTML y CSS o usar un procesador Markdown que permita estilos personalizados.