Como gerar arquivos markdown com blocos de código corretamente no Cursor

Se você já tentou gerar documentação em markdown com o Cursor, deve ter notado que ele não consegue escrever snippets de código. Logo no primeiro bloco de código ele interrompe a edição do arquivo. Isto é devido aos triple backticks.

Eis aqui uma solução simples para o bug: https://www.youtube.com/watch?v=f7JOozZko40

No Cursor, em Rules for AI, inclua as seguintes instruções:

- When proposing an edit to a markdown file, first decide if there will be code snippets in the markdown file.
- If there are no code snippets, wrap the beginning and end of your answer in backticks and markdown as the language.
- If there are code snippets, indent the code snippets with two spaces and the correct language for proper rendering. Indentations level 0 and 4 is not allowed.
- If a markdown code block is indented with any value other than 2 spaces, automatically fix it

Isto basicamente instrui o Cursor a indentar com dois sepaços todos os blocos de código e incluir a linguagem do bloco logo após abrir os backticks.

Simples e funcional.

Agora você pode pedir para o seu Cursor escrever a documentação inteira do seu projeto na íntegra - que eu sei que você estava tentando - e ele o fará.