105 votes

OldPeculier avatar

Balise Markdown pour le titre du document

Demandé el 14 de Juin, 2013
Quand la question a-t-elle été
77509 affichage
Nombre de visites la question a
5 Réponses
Nombre de réponses aux questions
Résolu
Situation réelle de la question

N'y a-t-il aucun moyen d'indiquer le titre du document dans un document Markdown ?

J'en suis venu à utiliser Markdown avec Sublime Text pour préparer un grand nombre de mes documents personnels et professionnels. Je souhaite souvent avoir une sorte d'en-tête de "premier niveau" analogue au style Titre de Word, par exemple. Donc, par exemple :

### Things to Do ###

At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way

Mais le ### Things to Do ### n'est pas respectée par Markdown, et je ne connais pas d'alternative. En existe-t-il une ?

Je pourrais utiliser le style Heading 1 pour le titre, puis Heading 2 pour le reste, mais si j'ai besoin d'une imbrication plus profonde des titres, je manque rapidement de profondeur. Et, après tout, un titre n'est pas fondamentalement une rubrique en soi. Ce serait bien, par exemple, si les analyseurs Markdown-to-HTML utilisaient le Titre de la page <title> ainsi que pour un en-tête de page à la manière des titres Word.

Demandé el 14 de Juin, 2013 par OldPeculier

Réponses

Trop de publicités?

58voto

Ian Walters avatar
Ian Walters Points 1539

Si vous vous référez spécifiquement au format pandoc markdown, l'approche la plus simple est d'utiliser '%', par ex.

% Document Title

# Header 1

content

## Header 2

## Header 2

voir http://pandoc.org/README.html#metadata-blocks pour plus d'informations sur pandoc markdown.

Répondu el 11 de Juin, 2015 par Ian Walters (1539 Points )

30voto

Ryan Prior avatar
Ryan Prior Points 1075

L'un des points intéressants de la conception de Markdown est que le HTML est explicitement autorisé. HTML5 a ajouté des sections de page sémantiques, notamment <header> et <main>, qui peuvent convenir au titre de votre page.

Par exemple :

<header>
Things to Do
============
</header>
<main>
At Home
=======
*    Mow the cat
*    Feed the lawn

At the Office
=============
*    Learn Markdown
*    Use Big-O notation in a clever way
</main>

Si vous préférez exclure le HTML, vous pouvez utiliser les titres de style Atx afin d'obtenir plus de deux niveaux de hiérarchie.

Par exemple :

# Things to Do

## At Home
*    Mow the cat
*    Feed the lawn

## At the Office
### Morning
*    Learn Markdown
*    Use Big-O notation in a clever way
### Afternoon
*    Read e-mails
*    Scrutinize LOLcats
Répondu el 14 de Juin, 2013 par Ryan Prior (1075 Points )

11voto

egor.ananyev avatar
egor.ananyev Points 177

Il existe une solution unique par force brute que j'ai pensé poster :

<font size="+12"><center>
    Things to Do
</center></font>

Il existe certainement une manière plus sophistiquée de procéder, mais j'ai trouvé que, dans la mesure où elle n'est utilisée qu'une fois par document, ce n'est pas si mal.

Répondu el 12 de Février, 2020 par egor.ananyev (177 Points )

7voto

RedGrittyBrick avatar
RedGrittyBrick Points 2470

Métadonnées du titre

Si vous utilisez MultiMarkdown, vous pouvez ajouter des métadonnées en haut du document.

format: complete
title: This is a title for the web-page
css: http://example.com/main.css

First line of visible text

Le titre sera inclus dans un <title> dans le <head> section

Vous pouvez aussi l'inclure par référence dans le corps en utilisant [%title] )

Sous-sous-titres

Il ne devrait pas y avoir de problème pour reconnaître ### au début de la première ligne comme un en-tête de niveau 3 pour générer <h3> tags. Je l'utilise dans plusieurs implémentations de Markdown/MultiMarkdown.

Vous pouvez le tester en utilisant La Dingus de John Gruber , Marquable etc.

Décalage de l'en-tête

Au moins certaines implémentations de Markdown/Multimarkdown vous permettent de spécifier un décalage pour les titres générés de façon à ce qu'ils génèrent <h2> y <h3> au lieu de <h1> y <h2> .

Cela vous permettrait de mettre, par exemple, <h1>Title</h1> o <h1>[%title]</h1> comme première ligne de votre document (après les déclarations de métadonnées).

Références

Répondu el 5 de Février, 2015 par RedGrittyBrick (2470 Points )

0voto

abalter avatar
abalter Points 600

Si cela ne vous dérange pas d'utiliser RStudio, les fichiers Rmd (rmarkdown) génèrent le titre à l'aide d'une section de métadonnées en haut, puis utilisent #+ pour les en-têtes.

Liens

Répondu el 29 de Novembre, 2018 par abalter (600 Points )

Questions en vedette

Top Tags

Dans notre réseau

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

Yandex
X