Um só estilo de markdown para todos, pessoas e agentes.
Regras da casa para títulos, listas, ênfase e espaçamento, aplicadas toda vez que um arquivo é salvo, iguais em todas as máquinas. Quem quer que tenha escrito, você, alguém da equipe ou um agente, o arquivo sai com uma só forma, então um diff mostra o que mudou de sentido e nada mais.
Grátis para macOS, Windows e Linux. Sem conta, sem assinatura.
As regras
A forma, nunca o sentido
Catorze regras cobrem aquilo sobre o que o markdown deixa as pessoas discordarem: um só marcador para toda lista, _emphasis_ ou *emphasis*, um único título principal sem pular níveis, linhas em branco em volta de títulos e de código, nada de espaços no fim da linha, e links soltos envolvidos para que funcionem. Cada uma é um botão ou uma escolha na página do plugin.
- Frontmatter, blocos de código e as regiões que um plugin escreve ficam intactos, byte a byte
- Ligado em toda raiz nova, com padrões que batem com o que os próprios Frameworks (as estruturas) iniciais do padrão escrevem
- Compartilhado com a raiz, para que ninguém aplique o próprio gosto
Ao salvar
Datas que se mantêm sozinhas
Uma regra ao salvar nomeia uma propriedade de data e a define como hoje, ou como a hora atual, sempre que um Blueprint (o plano) é salvo: pela página, por eidos property set ou por um plugin. O date_modified deixa de ser algo que as pessoas esquecem.
Desvio
Pego quando vem de fora
Um arquivo escrito no seu próprio editor, pelo git ou por um agente que pulou a CLI não passa pelo linter no momento em que é escrito. É a verificação de saúde que pega: cada regra quebrada é um aviso no arquivo, com Lint ao lado como correção, e Revisar todos os arquivos acerta a raiz inteira de uma vez.
Como se conecta
A parte silenciosa de manter os arquivos confiáveis.
- Blueprints
Os desvios aparecem na verificação de saúde como avisos
linter/<rule>, ao lado dos apontamentos do próprio Framework. - Agente de IA
Um agente que escreve pelo
eidosganha o estilo da casa de graça; um que escreve o arquivo diretamente é pego pela verificação. - Git
Uma só forma para cada arquivo mantém os diffs no que mudou, não em como o editor de alguém espaça uma lista.
- Comentários
Os tópicos que os Comentários escrevem em um Blueprint passam pelas mesmas regras.
Pelo terminal
As mesmas regras, pelo terminal
eidos linter lista o que as regras mudariam, e --fix escreve isso e nada mais: nenhuma regra ao salvar roda, então corrigir um espaço nunca mexe em uma data.
$ eidos linter configure:on-save set date_modified today
✓ date_modified set to today on save (.eidos/plugins/linter/settings.yaml)
$ eidos linter
✗ specs/discovery/watchlist.md trailing-whitespace, heading-levels, heading-punctuation, list-marker, bare-urls, blank-lines, heading-blank-lines
1 file drifted; eidos linter --fix settles them
$ eidos linter --fix
✓ specs/discovery/watchlist.md trailing-whitespace, heading-levels, heading-punctuation, list-marker, bare-urls, blank-lines, heading-blank-lines
$ eidos linter
clean: 14 files as the rules would write themEscreva o que você está criando.
Baixe o Eidos MD, abra uma pasta e comece pelo Framework mais próximo do seu trabalho. Tudo o que ele te dá pode ser remodelado depois.
Grátis para macOS, Windows e Linux. Seus arquivos continuam texto simples, em uma pasta que é sua.