Anuncio de la extensión Docs Markdown para Visual Studio Code

Esta publicación fue escrita por Adam Kinney, ingeniero de software senior en el equipo de docs.microsoft.com.

Hoy, estamos encantados de anunciar el lanzamiento del Docs Authoring Pack para Visual Studio Code, lo que facilita la contribución a docs.microsoft.com. Esta primera versión del paquete incluye tres extensiones:

• de Markdown de Docs: proporciona ayuda para la creación de Markdown, incluida la creación de formato de texto, la inserción de listas y tablas, la inserción de vínculos a otro contenido y la adición de imágenes y otros recursos. A diferencia de otros editores de Markdown, Docs Markdown admite extensiones de Markdown personalizadas para docs.microsoft.com, como alertas y fragmentos de código.
• DocFX: proporciona una versión preliminar limitada de Markdown específica de docs.microsoft.compara ayudar a ver el aspecto del archivo Markdown cuando se publique.
• markdownlint: un conocido linter de Markdown de David Anson para ayudar a garantizar que Markdown siga los procedimientos recomendados.

Cómo funciona

En primer lugar, deberá instalarlo desde Visual Studio Marketplace. Una vez que vaya a la página de extensión , simplemente haga clic en Instalar y siga los mensajes en la pantalla:

Una vez hecho esto, debe volver a cargar Visual Studio Code, abrir un archivo Markdown y empezar a escribir. Use la combinación de teclas de Alt+M para acceder a la paleta de comandos de la extensión de Markdown de Docs, lo que le permite dar formato rápidamente al texto (por ejemplo, hacer negrita o cursiva), insertar entidades markdown estándar, como una lista numerada o una tabla, así como insertar marcado específico de documentos para notas, información importante y sugerencias:

También puede insertar código rápidamente desde otros archivos a través de una extensión Markdown compatible con DocFXy obtener una vista previa de la página en la que trabaja directamente en el editor:

Contribuir

La extensión es código abierto, y agradecemos cualquier contribución a ella.

La mayoría de las contribuciones requieren que acepte un Contrato de licencia de colaborador (CLA) afirmando que tiene derecho a, y en realidad, concedanos los derechos para usar su contribución. Para obtener más información, visite https://cla.microsoft.com.

Al enviar una solicitud de incorporación de cambios, un bot CLA determinará automáticamente si necesita proporcionar un CLA y decorar la solicitud de incorporación de cambios de forma adecuada (por ejemplo, etiqueta, comentario). Solo tiene que seguir las instrucciones proporcionadas por el bot. Solo tendrá que hacerlo una vez en todos los repositorios propiedad de Microsoft mediante nuestro CLA.

Enviar comentarios

¿Pensamos en cómo podemos mejorar la extensión? Simplemente abrir un nuevo problema!

Y no olvide seguir nuestra cuenta de Twitter de para obtener las actualizaciones más recientes.

¿Sueñas con mejorar el mundo para los desarrolladores? Unirse a nuestro equipo!