Styliser la Documentation Technique
Paramètrès parfaits pour le code et la documentation API
Aperçu
La documentation technique a des exigences uniques: présentation claire des blocs de code, coloration syntaxique et polices monospace qui distinguent le code de la prose.
Velvet MD excelle dans le rendu des fichiers README, de la documentation API et des tutoriels riches en code.
Exemple de Documentation Technique
Voyez comment le modèle Terminal rend un guide d'installation:
# Installation Guide
## Prerequisites
- Node.js 18+
- npm or yarn
## Quick Start
```bash
npm install @mylib/core
```
## Basic Usage
```javascript
import { Client } from '@mylib/core';
const client = new Client({
apiKey: process.env.API_KEY
});
const result = await client.query('data');
console.log(result);
```
> **Note:** Always use environment variables for API keys.
Installation Guide
Prerequisites
- Node.js 18+
- npm or yarn
Quick Start
npm install @mylib/core
Basic Usage
import { Client } from '@mylib/core';
const client = new Client({
apiKey: process.env.API_KEY
});
const result = await client.query('data');
console.log(result);
Note: Always use environment variables for API keys.
Pourquoi Ça Paraît Technique
Le modèle Terminal crée une apparence conviviale pour les développeurs grâce à des choix de design spécifiques:
- Polices monospace — Le code apparaît avec une largeur de caractères cohérente pour une lecture facile
- Coloration syntaxique — Les mots-clés, chaînes et commentaires sont codés par couleur pour un balayage rapide
- Fond sombre — Correspond à l'environnement terminal/IDE que les développeurs connaissent
- Espacement compact — Plus de contenu tient à l'écran, réduisant le défilement pendant la référence
Modèles Recommandés
Ces modèles sont optimisés pour le contenu technique:
syntax highlight.Conseils Markdown pour la Documentation
Ces fonctionnalités markdown sont essentielles pour l'écriture technique:
Ajoutez le nom du langage pour la coloration syntaxique. Supporte plus de 100 langages.
```javascript
const config = { debug: true };
```
Enveloppez les noms de variables, fonctions ou commandes avec des backticks pour l'emphase.
Run `npm install` to install dependencies.
Utilisez des citations avec des étiquettes en gras pour les avertissements, notes et conseils.
> **Warning:** This action is irreversible. > **Note:** See the API reference for details.
Documentez les paramètrès API avec des noms en gras et du code en ligne pour les types.
**Parameters:** - `apiKey` (string) - Your API key - `timeout` (number) - Request timeout in ms
Fonctionnalités des Blocs de Code
Velvet MD fournit une excellente présentation du code:
- Coloration syntaxique automatique pour plus de 100 langages
- Police de code configurable (Fira Code, JetBrains Mono, etc.)
- Option de coins arrondis ou nets pour les blocs de code
JavaScript, TypeScript, Python, Bash, JSON, HTML, CSS, SQL, Go, Rust, Java, C#, PHP, Ruby, Swift, Kotlin, and more.
Exporter la Documentation
Choisissez selon la façon dont la documentation sera utilisée:
- HTML — Meilleur pour l'hébergement sur des sites web ou intranets
- DOCX — Préserve les couleurs de coloration syntaxique dans Word
Prêt à Styliser Votre Documentation?
Commencez avec le modèle Terminal pour un aspect convivial pour les développeurs.
Essayer le Modèle Terminal