Text styles and screenshots

Dradis uses Textile markup to format text. However, we do not support all of the Textile formatting options. The formatting options listed here are the full list of supported styles. It is possible to force Dradis to display other formatting options, but only the styles and formatting options listed here will export into your reports as expected.

In this page:

Bold and italic

New lines and paragraphs

If you want separate paragraphs in Word, you have to use two new line characters in Dradis:

Will render in Word like:

If you use a single new line character in Dradis:

The rendered Word will look like:

Bullet point and numbered lists

Screenshots and captions

To include a screenshot in your report, upload it as an attachment to your node by clicking the green and selecting the image from your local system. You can also upload the file by dragging and dropping the image to the Drop zone or by pasting the image directly from your clipboard (if your browser supports it):

Make sure to click the blue icon to finish the upload:

We need to include the link to the attachment in the project. Click the icon to copy the URL to your clipboard.

Now, paste the image URL into the correct location in your project. Now that the file is "living" within Dradis, you can include the URL anywhere in your project (an Issue, Evidence, or Note). Remember to use the Textile markers for embedding images, i.e. !<URL>!:

And the screenshot will be rendered in Word as expected:

Note: make sure to add new blank lines before and after your screenshots so that they are rendered correctly. For example, if you are adding two screenshots in a row, format them like this:

#[Details]#
A screenshot showing the attack payload in action:

!http://dradis-pro.dev/nodes/4747/attachments/dradispro-01.png!

!http://dradis-pro.dev/nodes/4747/attachments/dradispro-02.png!
    

Instead of like this:

#[Details]#
A screenshot showing the attack payload in action:
!http://dradis-pro.dev/nodes/4747/attachments/dradispro-01.png!
!http://dradis-pro.dev/nodes/4747/attachments/dradispro-02.png!
    


Create an image caption

Add a screenshot to your project using the instructions above. Again, you can use the Textile markers for image captions, i.e. !<URL>(Sample image caption)!:

Click Update Evidence, then mouseover the image to see the caption within Dradis:

The screenshot will export into your Word report and the caption will be prepended with Figure # as shown below:

Click image for fullscreen view


The sequence field (# in Figure # above will be automatically created and the field may need to be updated after you export.

Style your captions

The Dradis reporting engine will detect the image captions in your project and style them just how you want them. First, you'll need to decide how you want to style them.

The captions use the built-in Caption style in your Word document. We'll need to modify that style to change the way that the captions are formatted:

  1. Open your Word document and click the small downward arrow in the bottom right of the Styles section of the Home tab.

  2. Inside the Styles pane, click Options in the bottom right corner.

  3. Under Select styles to show: select All styles, then click OK.

  4. Back in the Styles pane, scroll down until you find the Caption style. Click the carat to the right of the name and then select Modify... from the pop-up that appears.

  5. Modify the style to match the formatting you need for your captions. We've applied color, indents, and more below. When you're ready, click OK to save your changes.

  6. Now, when you export a Dradis project using this Word report template, all of the captions will use the Caption style we just modified:

Next help article: Code blocks →