MarkdownCanDo

MarkdownCanDo é um site interativo para aprender, escrever e explorar os recursos do Markdown.

Desenvolvimento local

Requer Node.js 20 ou superior e pnpm 10.

pnpm install
pnpm dev

O comando de desenvolvimento detecta conflitos de porta e escolhe automaticamente a próxima porta disponível.

Para compilar e visualizar a versão de produção:

pnpm build
pnpm preview

Implantação no Cloudflare

O site usa Cloudflare Worker Static Assets, um bucket R2 privado e um Durable Object SQLite para imagens temporárias. Antes de implantar uma cópia, revise o domínio e os limites IMAGE_* em wrangler.jsonc.

Na primeira implantação, crie o bucket Standard privado markdown-can-do-uploads, mantenha r2.dev e domínios públicos desativados e adicione a regra de ciclo de vida de 1 dia para uploads/. Os comandos, o cálculo das cotas, a verificação contra hotlink e o monitoramento estão no guia de imagens no Cloudflare.

pnpm test
pnpm typecheck
pnpm cloudflare:deploy:dry
pnpm cloudflare:deploy

O redirecionamento do domínio antigo é mantido separadamente em wrangler.redirect.jsonc.

Tecnologias

• VitePress e Vue
• Milkdown Crepe para edição WYSIWYG
• markdown-it e DOMPurify para renderização e sanitização
• Mermaid, KaTeX e ABCJS para conteúdo estendido
• Cloudflare Workers Static Assets
• Armazenamento privado de imagens no Cloudflare R2 e cotas com Durable Object

Tradução

O chinês é a versão principal. Os conteúdos em inglês e português podem ficar temporariamente defasados e devem ser revisados após mudanças de texto.

Estado da versão

A v0.9 é uma versão anterior à 1.0. A experiência principal já pode ser implantada e utilizada; cobertura de conteúdo, acessibilidade, tamanho dos pacotes e compatibilidade do editor continuarão sendo melhorados antes da v1.0.