Skip to content

MarkdownCanDo

Tutorial interativoVisitar o site

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

Prévia da página inicial

Desenvolvimento local

Requer Node.js 20 ou superior e pnpm 10.

bash
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:

bash
pnpm build
pnpm preview

Implantação no Cloudflare

O site usa Cloudflare Worker Static Assets. Antes de implantar uma cópia, revise o domínio personalizado em wrangler.jsonc.

bash
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

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.