diff --git a/src/Symfony/Bundle/FrameworkBundle/Command/ContainerDebugCommand.php b/src/Symfony/Bundle/FrameworkBundle/Command/ContainerDebugCommand.php
index 64765c909609..fee2c6543e30 100644
--- a/src/Symfony/Bundle/FrameworkBundle/Command/ContainerDebugCommand.php
+++ b/src/Symfony/Bundle/FrameworkBundle/Command/ContainerDebugCommand.php
@@ -46,7 +46,7 @@ protected function configure()
                 new InputOption('tags', null, InputOption::VALUE_NONE, 'Displays tagged services for an application'),
                 new InputOption('parameter', null, InputOption::VALUE_REQUIRED, 'Displays a specific parameter for an application'),
                 new InputOption('parameters', null, InputOption::VALUE_NONE, 'Displays parameters for an application'),
-                new InputOption('format', null, InputOption::VALUE_REQUIRED, 'To output description in other formats'),
+                new InputOption('format', null, InputOption::VALUE_REQUIRED, 'To output description in other formats', 'txt'),
                 new InputOption('raw', null, InputOption::VALUE_NONE, 'To output raw description'),
             ))
             ->setDescription('Displays current services for an application')
@@ -114,7 +114,9 @@ protected function execute(InputInterface $input, OutputInterface $output)
         }
 
         $helper = new DescriptorHelper();
-        $helper->describe($output, $object, $input->getOption('format'), $input->getOption('raw'), $options);
+        $options['format'] = $input->getOption('format');
+        $options['raw_text'] = $input->getOption('raw');
+        $helper->describe($output, $object, $options);
     }
 
     /**
diff --git a/src/Symfony/Bundle/FrameworkBundle/Command/RouterDebugCommand.php b/src/Symfony/Bundle/FrameworkBundle/Command/RouterDebugCommand.php
index 4a4971542997..f516f96d2af7 100644
--- a/src/Symfony/Bundle/FrameworkBundle/Command/RouterDebugCommand.php
+++ b/src/Symfony/Bundle/FrameworkBundle/Command/RouterDebugCommand.php
@@ -52,7 +52,7 @@ protected function configure()
             ->setDefinition(array(
                 new InputArgument('name', InputArgument::OPTIONAL, 'A route name'),
                 new InputOption('show-controllers', null,  InputOption::VALUE_NONE, 'Show assigned controllers in overview'),
-                new InputOption('format', null, InputOption::VALUE_REQUIRED, 'To output route(s) in other formats'),
+                new InputOption('format', null, InputOption::VALUE_REQUIRED, 'To output route(s) in other formats', 'txt'),
                 new InputOption('raw', null, InputOption::VALUE_NONE, 'To output raw route(s)'),
             ))
             ->setDescription('Displays current routes for an application')
@@ -80,7 +80,11 @@ protected function execute(InputInterface $input, OutputInterface $output)
             if (!$route) {
                 throw new \InvalidArgumentException(sprintf('The route "%s" does not exist.', $name));
             }
-            $helper->describe($output, $route, $input->getOption('format'), $input->getOption('raw'), array('name' => $name));
+            $helper->describe($output, $route, array(
+                'format'   => $input->getOption('format'),
+                'raw_text' => $input->getOption('raw'),
+                'name'     => $name,
+            ));
         } else {
             $routes = $this->getContainer()->get('router')->getRouteCollection();
             $helper->describe($output, $routes, array(
diff --git a/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/MarkdownDescriptor.php b/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/MarkdownDescriptor.php
index d3210e0c61d2..c2a7bb1ebb55 100644
--- a/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/MarkdownDescriptor.php
+++ b/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/MarkdownDescriptor.php
@@ -28,6 +28,7 @@ protected function describeRouteCollection(RouteCollection $routes, array $optio
             }
             $this->describeRoute($route, array('name' => $name));
         }
+        $this->write("\n");
     }
 
     /**
@@ -49,8 +50,9 @@ protected function describeRoute(Route $route, array $options = array())
             ."\n".'- Path-Regex: '.$route->compile()->getRegex();
 
         $this->write(isset($options['name'])
-            ? $options['name']."\n".str_repeat('-', strlen($options['name']))."\n".$output
+            ? $options['name']."\n".str_repeat('-', strlen($options['name']))."\n\n".$output
             : $output);
+        $this->write("\n");
     }
 
     /**
@@ -133,17 +135,17 @@ protected function describeContainerServices(ContainerBuilder $builder, array $o
         }
 
         if (!empty($services['definitions'])) {
-            $this->write("\n\nDefinitions\n-----------");
+            $this->write("\n\nDefinitions\n-----------\n");
             foreach ($services['definitions'] as $id => $service) {
-                $this->write("\n\n");
+                $this->write("\n");
                 $this->describeContainerDefinition($service, array('id' => $id));
             }
         }
 
         if (!empty($services['aliases'])) {
-            $this->write("\n\nAliases\n-------");
+            $this->write("\n\nAliases\n-------\n");
             foreach ($services['aliases'] as $id => $service) {
-                $this->write("\n\n");
+                $this->write("\n");
                 $this->describeContainerAlias($service, array('id' => $id));
             }
         }
@@ -182,7 +184,7 @@ protected function describeContainerDefinition(Definition $definition, array $op
             }
         }
 
-        $this->write(isset($options['id']) ? sprintf("**`%s`:**\n%s", $options['id'], $output) : $output);
+        $this->write(isset($options['id']) ? sprintf("%s\n%s\n\n%s\n", $options['id'], str_repeat('~', strlen($options['id'])), $output) : $output);
     }
 
     /**
@@ -193,7 +195,7 @@ protected function describeContainerAlias(Alias $alias, array $options = array()
         $output = '- Service: `'.$alias.'`'
             ."\n".'- Public: '.($alias->isPublic() ? 'yes' : 'no');
 
-        $this->write(isset($options['id']) ? sprintf("**`%s`:**\n%s", $options['id'], $output) : $output);
+        $this->write(isset($options['id']) ? sprintf("%s\n%s\n\n%s\n", $options['id'], str_repeat('~', strlen($options['id'])), $output) : $output);
     }
 
     private function formatRouterConfig(array $array)
diff --git a/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/TextDescriptor.php b/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/TextDescriptor.php
index ce53d832044e..9a9b6fd0fdd2 100644
--- a/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/TextDescriptor.php
+++ b/src/Symfony/Bundle/FrameworkBundle/Console/Descriptor/TextDescriptor.php
@@ -84,7 +84,7 @@ protected function describeRoute(Route $route, array $options = array())
             $description[] = '<comment>Host-Regex</comment>   '.$route->compile()->getHostRegex();
         }
 
-        $this->writeText(implode("\n", $description), $options);
+        $this->writeText(implode("\n", $description)."\n", $options);
     }
 
     /**
@@ -256,7 +256,7 @@ protected function describeContainerDefinition(Definition $definition, array $op
         $description[] = sprintf('<comment>Synthetic</comment>        %s', $definition->isSynthetic() ? 'yes' : 'no');
         $description[] = sprintf('<comment>Required File</comment>    %s', $definition->getFile() ? $definition->getFile() : '-');
 
-        $this->writeText(implode("\n", $description), $options);
+        $this->writeText(implode("\n", $description)."\n", $options);
     }
 
     /**