1 In this paper we show how descriptive markup technologies can help teachers in the production of learning content that later could be used for many different purposes with different pedagogical approaches and for many different platforms. Our approach is illustrated using a manual-writing metaphor for the production of learning contents in the Computer Science domain.