In the readme.txt file, the “Screenshots” section is a special section. The WordPress plugin repository checks your Assets folder (or the folder containing readme.txt) for images named in a certain way and corresponds them to the entries in this section. I don’t believe it is possible to attach images in the same way in any other section.
Markdown does provide a syntax for including images:

However, I tried to make this work in the WordPress readme.txt validator, and I couldn’t. It looks like the plugin repo strips these out, but I haven’t actually tried it in a plugin’s readme.txt and committed it to see what would happen.
Related Posts:
- Can a developer adopt a plugin marked as “not updated in over 2 years”?
- Get a list of all WordPress.org Plugins?
- Can I change ownership of my plugin?
- How can I prevent a plugin from updating unless it’s minimum PHP version is met?
- Allowing Two Developers Access to a Plugin on the WordPress.org Plugin Repository?
- “Donate to this plugin” for WordPress.org Plugin Authors
- Making plugin unique to not conflict with plugins with the same name
- How do I retrieve a list of popular plugins using the WordPress.org Plugin API?
- How long does it take for a new plugin to be approved?
- How is the WordPress.org plugin download history calculated?
- WordPress plugin update not showing on wp.org [closed]
- Licensing: Can I include SWFs without source in a plugin released on wordpress.org?
- Licensing of freemium plugin
- Why was my plugin rejected from the WordPress.org repository?
- wordpress.org codebase
- Can a manually uploaded plugin be made to track updates from the WordPress.org plugin directory?
- Can WordPress Plugin Directory Cache Delay the Upload of Images?
- How to checkout the wordpress.org plugin repository?
- WordPress plugin compatibility explaination when wordpress releases its new version (theoretical)
- How can I prevent my plugin go development trunk [closed]
- Plugin development: Buggy plugin preview
- Where can I always find the price of a plugin
- WordPress SVN UTF-8 issue
- WordPress.org: How to add a plugin for certain countries?
- Readme.txt not getting updated
- Change plugin author after someone leaves the company
- Is it okay to make a plugin to the WordPress repo, but limit it’s actions to maximum N events?
- Better search on WordPress.org Plugins?
- how to check plugin name unique or not?
- Can a developer adopt a plugin marked as “not updated in over 2 years”?
- What is the RSS feed link for the newest WordPress plugins?
- How to edit the name of a plugin on wordpress.org/plugins
- On WordPress.org Plugin repository, Last Updated Date doesn’t match with Plugin Version Update Date
- remover item do carrinho na página de checkout
- How to view Plugin Manager in Notepad++
- Use Notepad++ as HEX-Editor
- fix the error : Plugin with id ‘com.android.application’ not found
- Best collection of code for your 'functions.php' file [closed]
- Tips for using WordPress as a CMS? [closed]
- Adding a Taxonomy Filter to Admin List for a Custom Post Type?
- Updates for a private plugin?
- Uninstall, Activate, Deactivate a plugin: typical features & how-to
- Best way to initiate a class in a WP plugin?
- Which banner plugin is this? [closed]
- Upgrade 4.5.2 to 4.5.3 deleting row in wp_options table
- Woocommerce – adding variations to variations [closed]
- Best way to include wp-config.php
- similar of my posts in all over the internet sites and blogs [closed]
- Between functions.php (theme), widgets, and plugins, which is loaded first?
- Create custom page templates with plugins?
- Custom Post Type Templates from Plugin Folder?
- to perform the requested action wordpress needs to access your web server. please enter your ftp
- Disable update notification for individual plugins
- Passing a parameter to filter and action functions
- Do deactivated plugins slow down a WordPress site?
- What security concerns should I have when setting FS_METHOD to “direct” in wp-config?
- How do you debug plugins?
- How to structure a plugin
- What’s the preferred method of writing AJAX-enabled plugins?
- Get Product id from order id in Woocommerce [closed]
- Add multiple plugin directories
- What are the differences between WPINC and ABSPATH?
- Translate a plugin using .po .mo files
- Best way to overide plugin CSS?
- How to add a shortcode button to the TinyMCE editor?
- Where do I put the code snippets I found here or somewhere else on the web?
- Is there a plugin that provides a stackoverflow style editor for wordpress? [closed]
- Get a list of all registered actions
- How can I force a file download in the WordPress backend?
- What Plugins Demonstrate Great WP Plugin Development? [closed]
- How to implement a customizable free OpenID authentication?
- Should all plugins be encapsulated in a Class?
- How to check if the product is in a certain category on a single-product.php in Woocommerce?
- How can I stop WordPress from prompting me to enter FTP information when doing updates?
- In what order does WordPress load plugin files?
- What Features would you Most Like to See Added to WordPress? [closed]
- Given the ID of a product in woocommerce, how can I get its URL?
- Adding Additional Attributes in Script Tag for 3rd party JS
- How can I edit post data before it is saved?
- Manually set global $post vars with an ID, in order to use template tags
- is_plugin_active function doesn’t exist
- How To Activate Plugins via Code?
- Disable plugin / plugin action via theme
- ‘Global’ settings page for multisite plugin
- Activate a plugin through PHPMyAdmin or FTP?
- What Are Security Best Practices for WordPress Plugins and Themes? [closed]
- How can I use WordPress functions in my stylesheet?
- How do I show data from gravity forms in my template? [closed]
- Show a different number of posts per page depending on context (e.g., homepage, search, archive)
- Creating a plugin with dependencies
- How can I make add_image_size() crop from the top?
- Implementing a CrunchBase.com Clone using WordPress?
- Difference between add_filter and apply_filters
- Add Google Analytics manually, or use a plug-in?
- How to enable suggested edits?
- Delete WordPress plugin Repository
- Disable email notification after change of password
- Custom pages with plugin
- How to change a user’s password programatically
- How to catch/what to do with a WP Error Object