Personal January 2021

Tutorial Markdown

Tutorial Markdown is a complete Markdown tutorial in Spanish: 210 pages across 31 sections, from what Markdown is to the parsers that read it, the apps that write it and the way large language models consume it. Next to the reading material there is an editor to practise in and an AI tutor that runs entirely inside the browser.

What it covers

The tutorial is organised the way someone actually meets Markdown: first what it is and why it exists, then the syntax, then the tools, and only afterwards the reference material.

Area What it includes
Introduction What Markdown is, what it is good for, and the versions of it that exist
Syntax Basic, extended and advanced syntax, plus the habits that keep a document readable
Tools Applications, editor extensions, utilities, chatbots and converters
Guides Tutorials, guides by profession and by sector, templates and comparisons
Prompting Markdown inside prompts, system prompts and prompt engineering
Reference Emojis, parsers, languages derived from Markdown, a glossary and an FAQ

The two largest sections are the ones that answer the question people actually arrive with: 52 pages on applications and 37 on practical advice, with another 17 on tools and 10 on chatbots.

The Playground

Reading about a syntax and writing it are different things, so the tutorial sends you to an editor to try it: Editor Markdown, which is a project of its own and lives at editormarkdown.com. It runs in the browser, keeps your documents in local storage, and links with GitHub, Bitbucket and Dropbox to import and save. You can export what you write as Markdown, as HTML, as HTML with its styles, or as PDF. It has autosave, word and character counts, synchronised scrolling between the source and the preview, configurable tab size, keyboard shortcuts and a night mode.

The AI tutor

A Markdown tutor you can ask questions, running on your own machine: the model is executed with WebLLM over WebGPU, inside the page. It downloads once and stays cached in the browser, so there is no account, no API key and no cost per question, and nothing you type reaches a server.

Markdown as the language models read

The part that aged into relevance. Markdown stopped being only a way to write a README the day chat assistants started answering in it and taking instructions in it, so the tutorial has its own section on Markdown inside prompts, on system prompts and on prompt engineering. It is the same syntax the rest of the site teaches, used for a job nobody had in mind when it was invented.

Status

Online since 2021 at tutorialmarkdown.com, and still growing.