Get a cue to inspire and spark creativity in your writing, then link your responses to other bloggers’ responses in the WordPress.com Reader.
When you use the Writing Prompt block, your post will be tagged accordingly and automatically shared with other people who use WordPress.com. You can opt out of this automatic tagging and sharing by removing the Writing Prompt tags.
Requirements
The Writing Prompt block is part of the Jetpack Blocks suite. See our Jetpack Blocks article to learn about the available blocks and how to activate them.
Jetpack Blocks require the Block Editor (also referred to as the Gutenberg editor). If you’ve installed the Classic Editor plugin, you have a few options:
Deactivate the Classic Editor: Go to Plugins → Installed Plugins in your WP Admin and deactivate the Classic Editor plugin.
Enable both editors: If you prefer flexibility, navigate to Settings → Writing in your WP Admin (not the menu under Jetpack settings). Set Allow users to switch editors to Yes. You will only see these options if you have the Classic Editor plugin installed and active.
Some custom themes or plugins may prevent you from using the Block Editor. In that case, please contact the support team for the plugin or theme for further assistance.
Add the Writing Prompt block to any post or page by searching for and selecting it in the block selector. You can only add the Writing Prompt block to a post or page once. If you attempt to add it again, it will appear disabled.
See our Jetpack Blocks page for more information about adding Jetpack blocks.
Writing prompt tags
When you add the Writing Prompt block to your post, dailyprompt tags will be automatically added and your post will be shown in the WordPress.com Reader.
If you don’t want to share your answer with other users, you can remove the tags after you put the block in your post.
To delete the tags, follow these steps:
Click the Settings icon in the top-right corner of the editor and look for the Tags section in the Post menu.
Under Add New Tag, find the tag you’d like to remove.
Click the X to remove the tag.
Block settings
After adding a Writing Prompt block, you can adjust the layout using the block sidebar.
Select Block on the right sidebar to open the Block Settings to customize the look of the block.
Main settings
You can choose to display or hide the upper and lower parts of the block, which consist of the daily prompt label and the link to other responses on the WordPress.com Reader.
Color settings
You can customize the color of the text, background, and links in the Writing Prompt block.
To set the custom color for your text, background, and links, follow these steps:
Click the Settings icon in the top-right corner of the editor and look for the Color section in the Block menu.
Click to open the color picker for each category.
Choose your desired color for text, background, and links.
Dimensions settings
Adjust the space around the Writing Prompt block by using the Dimensions setting. You can change the amount of padding both inside the border and within the margins above and below the block.
Use the slider or enter a specific value to adjust the spacing or click the link icon to change the values individually.
Compose posts and comments with links, lists, and other styles with Markdown, using regular characters and punctuation marks.
You can use Markdown on your Jetpack-powered blog for posts, pages, and comments. Here, you can find details and information on how to enable Markdown on your blog and write with it if you use the Classic Editor. See the Jetpack Markdown Block support guide for more information on using Markdown in the Block Editor.
Markdown is used by writers and bloggers who want a quick and easy way to write rich text without having to take their hands off the keyboard and without learning a lot of complicated code and shortcuts.
If you’re already familiar with Markdown, simply enable it on your blog and start writing. Refer to the WordPress.com Markdown Quick Reference page for help. Jetpack uses Markdown Extra, which adds some features not originally available in Markdown. For best results, please use the Text tab in the Editor, as the Visual editor can give unexpected results. See below for more details.
Enable Markdown
You can enable the Markdown for Classic Editor by following these steps,
From the Jetpack page in your Dashboard, go to Settings → Writing.
Head to the Composing section.
From there, activate the “Write posts or pages in plain-text Markdown syntax” option.
Once activated, Markdown is enabled for posts and pages and is available to all users on your blog.
To enable Markdown for comments:
From your dashboard, go to Settings → Discussion → Comments
Toggle the “Enable Markdown use for comments” option.
Click on Save Settings to apply.
Visitors to your blog can now compose comments using Markdown.
Write content with Markdown
Markdown uses special characters and punctuation marks to indicate styles and links. The specific characters you use and how you place them in the document are key to how your document will be formatted.
Markdown converts these special characters to the appropriate formatting when the document is published. For best results, use the Text tab in the Editor. The Visual Editor can produce unexpected results.
For example, in Markdown, to emphasize a word, you wrap it with an asterisk on both ends, like this: *emphasized*. When your writing is published, it will look like this: emphasized. Similarly, two asterisks denote strong text: **strong** will be published as strong.
To indicate links, use regular and square parentheses. Wrap the text you want to link in square parentheses; immediately after it, insert the link target, wrapped in regular parentheses. The actual Markdown could look like this: [Jetpack.com](https://jetpack.com/). When published, it will be a standard link: Jetpack.com.
On the left: using Markdown to compose a post in the fullscreen editor. On the right: The published post.
The original Markdown text you write will always remain in Markdown, so you can go back and edit it using Markdown. Only the published document – the post or the page – will be converted.
If you write a post in Markdown, it will be published as a fully formatted post on your blog, but when you go back and edit, it’ll still be in Markdown.
The best way to get started with Markdown is to experiment. Open the Markdown Quick Reference guide, start a draft post on your blog, and try to use the different features.
Markdown Extra and Markdown in Jetpack
Jetpack uses Markdown Extra by Michel Fortin. It includes features not originally available in Markdown, including improved support for inline HTML, code blocks, tables, and more. Code blocks can use three or more backticks (```), as well as tildes (~~~).
However, the Markdown block currently follows the CommonMark spec. For more information, you can refer to the official CommonMark spec.
About Markdown
Markdown was created by John Gruber and Aaron Swartz in 2004 as a solution for easily composing richly formatted text on the web. It employs plain text only and is based on conventions established in the computer and technology industry for writing emails and other documents with limited resources.
In plain text documents, the text you see on the screen represents all the information in the file, with no formatting or other data hidden from view. Plain text documents have been used for decades for their simplicity, portability, and reliability. You can probably still open and edit any plain text document from the past 40 years on any computing device available today.
Markdown has seen popular adoption on the web since it was first introduced, and it is now included in many sites and software programs.
MarkPad is an open-source Markdown editor for Windows.
Texts is a Markdown editor for Mac and Windows, which can convert Markdown to many formats, including PDF and Word documents.
Byword is a Markdown editor for Mac, iPhone, and iPad.
Simplenote is a cross-platform note-taking service by Automattic, with Markdown support.
Add Markdown support to your Custom Post Types.
There are two different options to add Markdown support to a specific Custom Post Type on your site.
You can add Markdown support to an existing post type thanks to the add_post_type_support() function. To do so, add the following code to a functionality plugin:
Markdown is deactivated by default. If you ever need to deactivate this feature, you can toggle the Write posts or pages in plain-text Markdown syntax setting in the Composing section from Jetpack > Settings > Writing in your dashboard.
Data Used
Site Owners / Users
For activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
Site Visitors
None.
Activity Tracked
Site Owners / Users
We track when, and by which user, the feature is activated and deactivated.
Start writing new content based on existing posts with the Jetpack Copy Post feature.
The Copy Post feature is compatible with Posts, Pages, Jetpack Testimonials, and Jetpack Portfolios, so you can duplicate content taken from these to start writing them faster.
Activate and use Copy Post
Go to Jetpack → Settings → Writing, and then find the Composing section.
Activate “Enable the option to copy entire posts and pages, including tags and settings”.
Go back to your WP Admin and head to the post type you will find the content to copy – for example, if you want to copy a blog post, head to WP Admin → Posts → All Posts.
In the post list view for supported post types, hover over the post you want to copy and click the Copy link:
If you don’t see the Copy link, your user account may not have the required permissions. Only users who can edit a post will be able to copy it.
A new post edit window will open with the following elements already copied over (if the original post has them):
Title
Content
Excerpt
Featured image
Categories
Tags
Comment and pingback status
Likes and Sharing Status
Custom post-type terms
You can now edit the copied post to your liking and publish it when you’re ready.
Copy Post and multisite networks
It’s not possible to copy a post from one multisite subsite to another. They are essentially separate sites with their own content and do not share post data.
Copying other post types
By default, the Copy Post feature supports:
Posts
Pages
Jetpack Portfolios
Jetpack Testimonials
You can enable the Copy Post for other post types, by using the copy post hook.
Copy Post is deactivated by default. It can be activated and deactivated from Jetpack → Settings → Writing.
Data Used
Site Owners / Users
Data of existing posts to which the user has edit access: title, post content, excerpt, categories, tags, featured image, comment and pingback status, likes and sharing status, custom post type terms.
Give your users the power to show comments some love!
To access Comment Likes, the site must have Comment Likes enabled and you must be logged into your WordPress.com account.
Enable Comment Likes
You can activate Comment Likes by following these steps:
Start at WP Admin.
Navigate to Jetpack > Settings > Discussion.
Click the toggle next to Enable Comment Likes to activate Comment Likes.
To disable Comment Likes, click the toggle again. The Comment Like button will disappear, and all Likes will no longer appear on any comments.
If Show Likes is deselected in the Likes and Shares box and/or Comments are disabled for a particular post, Comment Likes will be disabled as well.
Manage Comment Likes
Control who can like comments with the Disallowed comments feature, following these steps:
Go to WordPress.com
Select the site you wish to control Comment Likes for
Go to Settings > Discussion.
If you see Comment Likes coming from a spam account or other source that you want to disallow, simply add the person’s email address, name, or username to the Disallowed comments dialogue box.
Scroll to the top of the Comments section and click Save Settings.
After following the above steps, the Comment Like option will no longer be visible for these visitors.
Troubleshoot Comment Likes
Likes disappeared
If you transfer your site or change the site URL settings, your Comment Likes count will be reset, and start counting again.
Likes cannot be migrated from one site to another.
Likes not loading
There is a known issue between Cloudflare’s Rocket Loader and Jetpack Likes. You’ll consequently need to disable this feature in your Cloudflare settings.
If you have a cache/optimization plugin minifying JavaScript, the minification could cause the Likes button to sit just Loading. Please, try to deactivate the minification to solve the issue.
Comment likes is deactivated by default. If you ever need to activate it, you can toggle the Enable comment likes setting from the Comments section at Jetpack — Settings — Discussion.
Data Used
Site Owners / Users
To formally process a like action, we use the WordPress.com user ID/username (you must be logged in to use this feature), the local site-specific user ID (if the user is signed in to the site on which the like occurred), and a true/false data point that tells us if the user liked a specific comment.If a like action is performed from one of our mobile apps, some additional information is used to track the activity: IP address, user agent, timestamp of event, blog ID, browser language, country code, and device info.
Additionally, for toggle tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
Site Visitors
To formally process a like action, we use the WordPress.com user ID (if the user is signed in to WordPress.com), the local site-specific user ID (if the user is signed in to the site on which the like occurred), and a true/false data point that tells us if the user liked a specific comment.If a like action is performed from one of our mobile apps, some additional information is used to track the activity: IP address, user agent, timestamp of event, blog ID, browser language, country code, and device info.
Data Tracked
Site Owners / Users
We track by who, and when, a specific comment was liked.We also track when, and by which user, the feature is activated and deactivated.
Site Visitors
We track by who, and when, a specific comment was liked.
You can integrate the Jetpack AI tools into the WordPress block editor. Use options like AI-generated text, post titles, excerpts, and feedback. You can also create feature images.
We offer everyone a limited number of free requests, with options to upgrade for more usage.
Writing Prompt Block
Break through those moments of not knowing where to start, with the Writing Prompt block.
With this feature, you can also include a link to other people’s writing on the same topic in the WordPress.com Reader.
Markdown
Compose posts and comments with links and lists with Markdown.
Writers and bloggers use Markdown to quickly write rich formatted text without taking their hands off the keyboard and without learning many complicated codes and shortcuts. The Markdown feature is available as a Block and in the Classic Editor.
Copy Post
Start new posts based on existing posts by using the Copy Post feature.
The feature works on Posts, Pages, Jetpack Testimonials, and Jetpack Portfolios. If you have similar content to create, you can avoid starting from scratch by copying previous content structures with one click.
Comment Likes
Give your users the power to show comments some love! To access Comment Likes, your site must have Comment Likes enabled, and you must be logged into your WordPress.com account.
Shortcodes Embed
Enhance your writing content by embedding media content via Jetpack shortcodes. You can embed videos from YouTube, messages from Threads, and other media across the web directly into your website with the Shortcodes feature. This will make your writing more interesting and engaging for your readers
You can also embed elements by pasting URLs on a line by itself in your visual editor.
Beautiful Math with LaTeX
LaTeX is a powerful markup language for writing complex mathematical equations, formulas, and more. With Beautiful Math with LaTeX, you can include math formulas, equations, and similar in your content, making them easy to write, read, and display.
Post by Email
Post by Email is a way of publishing posts on your blog by email. you can use any email client to send the email, so you can publish quickly and easily from mobile and desktop devices when you can’t or don’t want to access your site directly.
Post by Email is also a posting option of the Jetpack App.
This shortcode only works when the corresponding feature is enabled.
[contact-form] shows a Jetpack contact form. Note – since Jetpack’s contact form is enabled by default and available in the Classic Editor and as a block, a shortcode shouldn’t be needed unless you use a different editor that requires only shortcodes. » Full instructions to embed a Jetpack form
Facebook and Instagram no longer support their oEmbed API. However, we’ve partnered with Meta to ensure this content continues to be displayed. Ensure your site is connected to Jetpack and paste the Facebook or Instagram content link in the post or page editor. Please note that for Instagram, the post embedded on the site will show a link to Instagram, where the post can be viewed.
Shortcode Embeds are deactivated by default. You can activate them at any moment from your WP Admin. To do so:
Go to Jetpack → Settings.
Click the Writing tab.
Scroll down to the Composing section and toggle on the Compose using shortcodes to embed media from popular sites option.
Data Used
Site Owners / Users
We use any information required for the actual configuration of any shortcodes; see the links in the above section accompanying each shortcode for those specific details. Note that, if you add a shortcode to one of your posts, anybody with access to edit that post will have access to those shortcode details. The following WordPress options are also used (these are synced): embed_autourls (Spotify, YouTube), page_on_front (Sitemap), embed_size_w (TED, YouTube).Additionally, for activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
Site Visitors
See the Jetpack Stats privacy documentation for some shortcodes that record impressions (VideoPress and Slideshow).Note that, due to the nature of shortcodes (i.e. third-party content embeds), it is possible that third-party services may make use of certain pieces of data.
Activity Tracked
Site Owners / Users
We track when, and by which user, the feature is activated and deactivated.
Site Visitors
VideoPress: video plays; Slideshow: image views.Note that, due to the nature of shortcodes (i.e. third-party content embeds), it is possible that third-party services may track activity in some instances.
We sync an option that identifies whether or not the feature is activated. We also sync which specific shortcodes are currently used/active on your site.
Site Visitors
None.
Comments Off on Embed media content using shortcodes with Jetpack
LaTeX is a powerful markup language for writing complex mathematical equations, formulas, and more. Jetpack combines the power of LaTeX and the simplicity of WordPress to give you the ultimate in math blogging platforms.
Follow these steps to enable LaTeX:
Visit Jetpack → Settings → Writing in your site’s WP Admin.
Scroll down to the Composing section
Toggle on the Use the LaTeX markup language to write mathematical equations and formulas option.
Now you can begin using LaTeX on your site!
How To Use LaTeX in Posts
To include LaTeX () code in your post, use the following:
If your LaTeX code is broken, instead of the equation, you’ll see an ugly yellow and red error message.
We can’t provide support for LaTeX syntax, but there are plenty of useful guides elsewhere online. Or a quick post in our forums might find you a solution. One thing to keep in mind is that WordPress puts all of your LaTeX code inside a LaTeX math environment. If you try to use LaTeX that doesn’t work inside the math environment (such as \begin{align} ... \end{align}), you will get an error:
How To Adjust LaTeX Size
You can change the size of the LaTeX by specifying an s parameter after the \LaTeX code.
$latex \LaTeX&s=X$
Where X goes from -4 to 4 (0 is the default). These sizes correspond to ‘s font size commands:
s=
font size
Example
-4
\tiny
-3
\scriptsize
-2
\footnotesize
-1
\small
0
\normalsize (12pt)
1
\large
2
\Large
3
\LARGE
4
\huge
Changing Colors in LaTeX
WordPress tries to guess the background and foreground colors of your site and generates the LaTeX image accordingly. But, you can also change the colors if you wish. You can do this by specifying bg and fg parameters after the LaTeX code to change the background and foreground colors, respectively. The colors must be in hexadecimal RGB format: ffffff for white, 0000ff for bright blue, etc.
$latex \LaTeX&bg=ffcccc&fg=cc00ff&s=4$
Available LaTeX Packages
WordPress.com uses standard LaTeX with the following packages:
Inspired when you’re on the go? Publish blog posts directly from an email account.
Enable Post by Email
Activate the Post by Email feature from Jetpack → Settings → Writing → Post by Email in your site’s WP Admin.
Create an email address
Post by Email requires an email address to post to, not from. To create this secret email address, please follow these steps:
Go to Jetpack → Settings → Writing → Post by Email.
Click the Create Address button. Jetpack will generate an email address which is a random string of letters and numbers, followed by @post.wordpress.com.
Click Regenerate address until you see an address you are happy with.
Make sure this address stays secret. Anyone who knows this address will be able to publish posts on your blog.
Note: The Post by Email feature is only usable via email clients. Our anti-spam controls will always block posts from PHP scripts, including PHPMailer.
Publish a post via email
To publish a post via email, follow these steps:
Compose an email from any email client which support rich text or HTML formatting. You may NOT use PHP scripts, including PHPMailer.
Use the address generated above as the recipient.
Use the subject line for the post’s title. If it’s not possible to provide a subject line due to your email provider, use a shortcode instead.
Use the email body for the post’s content. Your email can be plain text or formatted. Be aware that the Post by Email system will strip any HTML tags that it thinks will interfere with a post’s display on your site. For example, italic and bold formatting will be retained, but colour and font changes will not.
Please note that you can only post by email to one site at a time. If you try to post to multiple email addresses at once, only the first one will be used.
Remove email signature
Post by Email will remove:
signatures that match the standard signature block pattern (that is, dash dash space)
Anything after a <hr/> HTML tag, and will attempt to clean up cellphone network signatures as well.
Content after a special [end] shortcode on its own line, with a blank line above it
Include attachments
Post by Email supports sending PDF files and images as attachments.
PDF attachments sent using Post by Email will appear at the bottom of your post, accessible by a link.
Image attachments will be included in your post as follows:
Single images will be displayed inline (a single image is defined as an image without another image immediately following it).
Multiple images will be displayed as a gallery.
Multiple galleries and single images are allowed in the same post. You can use the [nogallery] shortcode to disable all galleries in a post.
Shortcodes
Shortcodes can be embedded in your email to configure various aspects of the published post. Include shortcodes anywhere in the body of your email, making sure they are in lowercase, and with no spaces between the left square bracket and the shortcode content.
The following shortcodes can be used when posting by email:
Add categories
[category x,y,z]
Add existing categories to your post, or create new categories. Categories must be comma separated.
[category holidays, main-dishes]
Note: it’s possible to add categories by matching existing category slugs. For example, ‘main-dishes’ may add the ‘Main Dishes’ category if it exists. If the ‘main-dishes’ category did not exist, however, then a new category with the slug and name ‘main-dishes’ would be created instead.
Add tags
[tags x,y,z]
As with categories, you can add any number of tags to your post, each separated by a comma. Add existing tags, or create new ones.
[tags one potato, two potato, three potato, more]
In this example, four tags will be added to your post: ‘one potato’, ‘two potato’, ‘three potato’, and ‘more’.
Delay publication of your post
[delay +1 hour]
The delay shortcode will accept any time allowed by PHP’s strtotime function. For example, you can use the following to delay your post by one hour, or two days, respectively.
[delay +1 hour] [delay +2 days]
Change your post status
[status publish | pending | draft | private]
Sometimes you may want your post to be private, or to be reviewed by yourself or someone else before being published. To do this, you can use the [status] shortcode to set the post status.
[status private]
This will post your content with a ‘private’ status.
[slug some-url-name]
Specify a post title
[title Your post title]
By default, the title of your post will be taken from the subject line of your email. In some instances, such as when sending an email from some cell phones or via a MMS-Email gateway, you may not be able to provide a subject. In these cases, you can set your post title from inside the email with a shortcode:
[title My Fancy Post]
This will set the title of your post to ‘My Fancy Post’.
Withhold email signature or other content
[end]
Everything after the [end] shortcode is ignored. If you use this, make sure it’s on its own line with a blank line above it.
Change auto-gallery options
This slideshow requires JavaScript.
– replaces the auto-gallery with a slideshow
[nogallery] – disables the auto-gallery and displays all images inline
Disable comments on a post
[comments on | off]
Use the above short code to turn comments on or off for a post.
Change a Post’s Jetpack Social settings
Jetpack’s Jetpack Social feature lets you notify other web services about your posts. With the [publicize] shortcode you can control this from Post by Email.
Note: your Jetpack Social settings must have been previously configured for these shortcodes to work. Importantly, if you have already configured Jetpack Social and don’t include these shortcodes in your post, then it will be shared to all of your connected Jetpack Social accounts.
The following Jetpack Social shortcodes are available:
[publicize off] – disable all Jetpack Social notifications.
[publicize facebook] – Sends a notification from Facebook only.
No.
Privacy Information
Post-by-email is de-activated by default. It can be activated any time by toggling the Publish posts by sending an email in the Post by Email section from Jetpack — Settings — Writing in your dashboard.
Data Used
Site Owners / UsersThis feature utilizes the local ID of the user configuring or publishing via this feature. This ID is used to check for an active Jetpack connection and actually create/update the email address for posting.Additionally, for activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
Site VisitorsNone.
Activity Tracked
Site Owners / UsersWe track when, and by which user, the feature is activated and deactivated. We also track when, and which, configuration settings are modified.
Site Owners / UsersWe sync options that identify whether or not the feature is activated and the configured email address used exclusively for posting content.
Site VisitorsNone.
Tagged0087be, 00be28|Comments Off on Post by Email
Enter your email address to receive news and updates from Jetpack
Markdown in Classic Editor
Compose posts and comments with links, lists, and other styles with Markdown, using regular characters and punctuation marks.
You can use Markdown on your Jetpack-powered blog for posts, pages, and comments. Here, you can find details and information on how to enable Markdown on your blog and write with it if you use the Classic Editor. See the Jetpack Markdown Block support guide for more information on using Markdown in the Block Editor.
Markdown is used by writers and bloggers who want a quick and easy way to write rich text without having to take their hands off the keyboard and without learning a lot of complicated code and shortcuts.
If you’re already familiar with Markdown, simply enable it on your blog and start writing. Refer to the WordPress.com Markdown Quick Reference page for help. Jetpack uses Markdown Extra, which adds some features not originally available in Markdown. For best results, please use the Text tab in the Editor, as the Visual editor can give unexpected results. See below for more details.
Enable Markdown
You can enable the Markdown for Classic Editor by following these steps,
Once activated, Markdown is enabled for posts and pages and is available to all users on your blog.
To enable Markdown for comments:
Visitors to your blog can now compose comments using Markdown.
Write content with Markdown
Markdown uses special characters and punctuation marks to indicate styles and links. The specific characters you use and how you place them in the document are key to how your document will be formatted.
Markdown converts these special characters to the appropriate formatting when the document is published. For best results, use the Text tab in the Editor. The Visual Editor can produce unexpected results.
For example, in Markdown, to emphasize a word, you wrap it with an asterisk on both ends, like this:
*emphasized*.When your writing is published, it will look like this: emphasized. Similarly, two asterisks denote strong text:**strong**will be published as strong.To indicate links, use regular and square parentheses. Wrap the text you want to link in square parentheses; immediately after it, insert the link target, wrapped in regular parentheses. The actual Markdown could look like this:
[Jetpack.com](https://jetpack.com/). When published, it will be a standard link: Jetpack.com.The original Markdown text you write will always remain in Markdown, so you can go back and edit it using Markdown. Only the published document – the post or the page – will be converted.
If you write a post in Markdown, it will be published as a fully formatted post on your blog, but when you go back and edit, it’ll still be in Markdown.
The best way to get started with Markdown is to experiment. Open the Markdown Quick Reference guide, start a draft post on your blog, and try to use the different features.
Markdown Extra and Markdown in Jetpack
Jetpack uses Markdown Extra by Michel Fortin. It includes features not originally available in Markdown, including improved support for inline HTML, code blocks, tables, and more. Code blocks can use three or more backticks (
```), as well as tildes (~~~).See the WordPress.com Markdown Quick Reference page for the most useful formatting and features offered by Markdown Extra. For more detailed information, see the original reference guide for Markdown and the Markdown Extra page.
However, the Markdown block currently follows the CommonMark spec. For more information, you can refer to the official CommonMark spec.
About Markdown
Markdown was created by John Gruber and Aaron Swartz in 2004 as a solution for easily composing richly formatted text on the web. It employs plain text only and is based on conventions established in the computer and technology industry for writing emails and other documents with limited resources.
In plain text documents, the text you see on the screen represents all the information in the file, with no formatting or other data hidden from view. Plain text documents have been used for decades for their simplicity, portability, and reliability. You can probably still open and edit any plain text document from the past 40 years on any computing device available today.
Markdown has seen popular adoption on the web since it was first introduced, and it is now included in many sites and software programs.
Add Markdown support to your Custom Post Types.
There are two different options to add Markdown support to a specific Custom Post Type on your site.
You can add Markdown support to an existing post type thanks to the
add_post_type_support()function. To do so, add the following code to a functionality plugin:add_action( 'init', 'my_custom_init' ); function my_custom_init() { add_post_type_support( 'product', 'wpcom-markdown' ); }You’ll need to replace “product” with your Custom Post Type name.
Alternatively, you can add Markdown support when registering the post type, like so:
// Register Custom Post Type function custom_post_type() { $labels = array( 'name' => _x( 'Products', 'Post Type General Name', 'text_domain' ), ); $args = array( 'label' => __( 'product', 'text_domain' ), 'supports' => array( 'title', 'editor', 'publicize', 'wpcom-markdown' ), ); register_post_type( 'product', $args ); } // Hook into the 'init' action add_action( 'init', 'custom_post_type', 0 );Still need help?
Please contact support. We’re happy to advise.
Privacy Information
Markdown is deactivated by default. If you ever need to deactivate this feature, you can toggle the Write posts or pages in plain-text Markdown syntax setting in the Composing section from Jetpack > Settings > Writing in your dashboard.
For activity tracking (detailed below): IP address, WordPress.com user ID, WordPress.com username, WordPress.com-connected site ID and URL, Jetpack version, user agent, visiting URL, referring URL, timestamp of event, browser language, country code.
None.
We track when, and by which user, the feature is activated and deactivated.
None.
We sync a single option that identifies whether or not the feature is activated.
None.