Publicité

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:

Markdown
# 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.
Terminal Template

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:

API Reference
const api = new API();
Terminal Fond sombre avec polices monospace. Le choix privilégié pour la documentation développeur.
README.md
npm install package
GitHub Style README GitHub familier. Parfait pour la documentation de projets open-source.
Documentation
Code with syntax highlight.
Dark Mode Confortable pour les longues sessions de lecture. Réduit la fatigue oculaire.

Conseils Markdown pour la Documentation

Ces fonctionnalités markdown sont essentielles pour l'écriture technique:

Blocs de Code Clôturés

Ajoutez le nom du langage pour la coloration syntaxique. Supporte plus de 100 langages.

```javascript
const config = { debug: true };
```
Code en Ligne

Enveloppez les noms de variables, fonctions ou commandes avec des backticks pour l'emphase.

Run `npm install` to install dependencies.
Encadrés d'Appel

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.
Listes de Paramètrès

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
Langages Supportés

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
Publicité