SidVal / dev.web

Repo "brainstorming" público sobre todo lo relacionado con Desarrollo Web
https://sidval.github.io/dev.web/
MIT License
3 stars 2 forks source link

Reglas en VS Code: markdownlint #2

Closed SidVal closed 6 years ago

SidVal commented 6 years ago

Con la extensión de VS Code: markdownlint, se aplican una serie de reglas que están super explicadas en el github del desarrollador, y podemos leerlas aquí.

La que más me molesta sin embargo, es una que uso bastante, cuando mezclo HTML con MD., por ejemplo al poner:

<div align="right">-- Fin de la clase --</div>

Aparece un aviso que indica:

[markdownlint] MD033/no-inline-html: Inline HTML [Element: div]

Si se quiere simular el comportamiento de las reglas en linea, podemos usar ésta web: https://dlaa.me/markdownlint/

Solución

Crear el archivo .markdownlint.json en la raíz del proyecto así cuando abra desde VS Code carga la extensión sabiendo que debe aplicar las excepciones a las reglas que uno desee.

En mi caso, la MD033, donde se indica:

To allow specific HTML elements, use the allowed_elements parameter.

Más información: https://github.com/DavidAnson/vscode-markdownlint#configure

Rules can be enabled, disabled, and customized by creating a JSON file named .markdownlint.json in any directory of a project. The rules defined by .markdownlint.json apply to Markdown files in the same directory and any sub-directories without their own .markdownlint.json.

Note: .markdownlint.json is used only if a project has been opened. When no folder is open or a file is not part of the current project, normal user and workspace settings apply (see below).

A custom configuration is often defined by a .markdownlint.json in the root of the project.