Complete Markdown guide for the FactoryCode blog

Headings

Use # to create headings. The more #, the smaller the heading:

# H1 — title (don't use in content, it's already in the hero)
## H2 — main section
### H3 — subsection
#### H4 — minor subtitle

Text

Basic text formatting:

bold — **text** italic — *text* strikethrough — ~~text~~ inline code — `text`

Lists

Unordered list:

• Item A
• Item B
  • Nested item
  • Another one
• Item C

Ordered list:

1. Install dependencies
2. Configure .env
3. Run migrations
4. Profit

Code blocks

Always specify the language after the three backticks — Highlight.js will apply syntax coloring automatically:

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;

#[Route('/blog', name: 'app_blog_')]
class BlogController extends AbstractController
{
    #[Route('/{slug}', name: 'show')]
    public function show(string $slug): Response
    {
        return $this->render('blog/show.html.twig', [
            'slug' => $slug,
        ]);
    }
}

SELECT a.title, u.name AS author, COUNT(c.id) AS comments
FROM blog_articles a
JOIN users u ON u.id = a.author_id
LEFT JOIN blog_comments c ON c.article_id = a.id
WHERE a.status = 'published'
GROUP BY a.id, u.name
ORDER BY a.published_at DESC;

php bin/console cache:clear
php bin/console doctrine:migrations:migrate --no-interaction

# compose.yaml
services:
  app:
    build: .
    volumes:
      - .:/var/www/html
  database:
    image: postgres:16-alpine

{
  "status": "ok",
  "data": {
    "id": 1,
    "title": "Sample article"
  }
}

Tables

Quotes

This is a simple quote. Use it to highlight important thoughts, warnings or someone else's words.

Note: Quotes can contain bold, inline code and other elements. You can also write across multiple lines — each one starts with >.

Links and images

Link: [Symfony](https://symfony.com) → Symfony

Image from an external URL: ![Image description](https://picsum.photos/800/400)

Separator

A horizontal line separating sections: ---

That's all you need to write professional technical articles. Write in the Write tab, see the preview by clicking Preview.