Markdown Block

With the Markdown block you can create formatted content using only regular characters and some punctuation marks. Markdown is used by writers and bloggers who want a quick and easy way to write formatted text, but without having to take their hands off the keyboard, and without learning a lot of complicated codes and shortcuts.

If you have Jetpack enabled but are not using the WordPress block editor, take a look at our Markdown support document for more information.  

Requirements

The Markdown block is enabled by default when you set up Jetpack.

Since it is a block only, it remains available even if you disable the Markdown feature in Jetpack → Settings → Writing → Composing.

Adding a Markdown block

You can add a Markdown Block to any post or page, by selecting it from the Jetpack section of the block picker:

jetpack-markdown-block

Learning Markdown

It’s easy to get started writing in Markdown! You can see the basics on this page. If you need a more detailed guide, there’s also a 10-minute tutorial.

Markdown Implementation

Our Markdown block uses the markdown-it parser, which supports the CommonMark spec. If you need full details of the syntax that our Markdown block supports, see the markdown-it demo page.

Comments Off on Markdown Block

Jetpack Blocks

The WordPress Block Editor transforms your way of writing from a single document to a collection of meaningful elements (blocks), with explicit structure. Jetpack includes some blocks of its own, which can help you create your pages exactly the way you want them.

What are blocks?

Blocks are the individual sections that make up a page. There are many block types for you to use, each block can be edited or moved independently of other blocks, and blocks can have their own formatting settings. For more information on blocks, read our guide to the WordPress Block Editor on WordPress.com

How can I add Jetpack’s blocks?

You can add a block using any of the  buttons, as explained here. You’ll then find all available Jetpack blocks under the Jetpack block category:

You can also search for a block by name using the search box, or by typing a forward slash followed by the block name, e.g. /markdown

Note that some Jetpack blocks require certain Jetpack features to be enabled, and some require a Jetpack plan. See the list below for further details.

What blocks does Jetpack include?

The following is a list of all blocks currently available in Jetpack.

  • Ad Block - The Ad block allows you to insert a Jetpack Ad unit anywhere within the content of any post or page.
  • Business Hours Block - The Business Hours block allows you to display your business’s opening hours on your site.
  • Calendly Block - Jetpack's Calendly block allows your visitors to schedule one-on-one appointments, group events, and team meetings directly from your website.
  • Contact Info Block - The Contact Info block lets you add your contact information (email address, physical address, phone number) to any post or page.
  • Donations Block - The Donations block lets you add a payment button to any post or page for donations, tips, and other contributions, using Stripe as the payment gateway.
  • Eventbrite Block - With the Eventbrite block you can embed events on posts or pages.
  • Form Block - The Form block lets you add a form to your post or page.
  • GIF Block - The GIF block allows you to easily search for and embed an animated GIF image from Giphy directly into a post or page on your WordPress site.
  • Google Calendar Block - The Google Calendar block allows you to easily embed a Google Calendar into your post or page
  • Image Compare Block - The Image Compare Block allows you to display and compare the differences between two images side by side (or above and below) thanks to a slider.
  • Latest Instagram Posts Block - The Latest Instagram Posts Block lets you display your most recent images from Instagram on your site. The block update automatically updates when you post new images to Instagram.
  • Loom Block - The Loom block allows you easily insert a Loom video message into your WordPress post or page. Requirements To use the Loom block, your site needs to have an active Jetpack plan at version 9.0 or above. Adding the Loom block You can add the Loom block by searching and/or selecting it from the Jetpack section […]
  • Mailchimp Block - The Mailchimp block allows visitors to join your Mailchimp list.
  • Map Block - The Map Block allows you to add a map to any post or page on your site.
  • Markdown Block - With the Markdown block you can create formatted content using only regular characters and some punctuation marks.
  • OpenTable Block - With the OpenTable block, you can add a reservation form on posts or pages.
  • Pay with PayPal - Pay with PayPal lets you add a payment button to any post or page, and immediately start taking PayPal payments for physical products, digital goods, or donations.
  • Payments Block - The Recurring Payments Block lets you add a payment button using Stripe as the payment gateway. It works for one-time and recurring payments or donations.
  • Pexels Free Photo Library - Certain photo-related Jetpack blocks integrate with the Free Photo Library, courtesy of Pexels. Pexels includes a library of over 40,000 beautiful copyright-free images to use on your site. Important note: Any images you import into your Media Library with the Free Photo Library will count against your server storage limits. Please consult your host’s customer […]
  • Pinterest Block - The Pinterest block is the easiest way to embed Pinterest content to your site: it allows you to embed boards, profiles, and pins.
  • Podcast Player Block - Jetpack's Podcast Player block allows you to easily show your visitors a listing of recent episodes from a podcast and play them on your website.
  • Related Posts Block - The Related Posts feature scans all of your posts' contents, analyzes it, and uses that to display contextual posts your visitors might be interested in reading after they're finished with the current post.
  • Repeat Visitor Block - The Repeat Visitor block enables the author to control the visibility of its nested block(s) depending on how many times a visitor has previously visited the page.
  • Revue Block - The Revue block creates a simple signup form for readers to opt-in to receive your newsletter.
  • Slideshow Block - The Slideshow block lets you insert an image slideshow into a post or page.
  • Star Rating Block - The Ratings block allows any site author to add reviews to the site.
  • Story Block - The Story block allows you to combine photos and videos to create an engaging, tappable full-screen slideshow on your site’s posts and pages. Stories published on your site won’t disappear after 24 hours and you can edit or add to stories after they are published.
  • Subscription Form Block - The Subscription Form Block allows you to insert a subscription form within the content area of any post or page, enabling your readers to get notifications when you publish new posts.
  • Using your Google photos with Jetpack - You can connect Jetpack to your Google account to use your Google Photos in Jetpack’s image-related blocks. The first time you choose to add Google Photos, you’ll be asked only once to authorize the connection. If you have multiple Google accounts, make sure you’re logged into the one you wish to link to Jetpack! Jetpack […]
  • Video Block - The Video block enhances the existing WordPress Video block and allows you to upload videos from your computer to be hosted on WordPress.com, rather than on your host’s servers.
  • WhatsApp Button Block - The WhatsAPP Button block will allow your customers to send you a message to enquire about your product or services, or to ask for support. Clicking on the button will open WhatsApp and pre-fill the phone number and initial message.
  • Tiled Gallery Block – With Tiled Galleries you can display your image galleries in four styles: tiled mosaic, circular grid, square tiles, and tiled columns.

Block extensions

Jetpack has also created extensions for some WordPress core blocks:

  • Unrolling Tweet Threads – This extension to the Twitter block allows you to import an entire Tweet thread into the editor as native blocks.

Troubleshooting

If you’re having trouble with any of the Jetpack blocks, please contact support for help.

Comments Off on Jetpack Blocks

Markdown

Markdown lets you compose posts and comments with links, lists, and other styles using regular characters and punctuation marks. 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 codes and shortcuts.

NOTE: This guide only applies to posts created with the Classic Editor. See the Jetpack Markdown Block support guide for more information on how to use the Markdown block. The Markdown block currently follows the CommonMark spec.

You can use Markdown on your Jetpack-powered blog for posts, pages and comments. This document will detail how to enable Markdown on your blog, and how to write with it.

If you are already familiar with Markdown, just 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.

Enabling Markdown

From the Jetpack page in your Dashboard, go to SettingsWriting and activate the “Write posts or pages in plain-test Markdown syntax” option in the Composing section.

Enable Markdown at Settings --> Writing --> Composing

Once it is activated, Markdown is enabled for posts and pages and available to all users on your blog.

To enable Markdown for comments, go to SettingsDiscussion → Comments in your dashboard, and toggle the option labeled Enable Markdown use for comments. Click on Save Settings to apply. Visitors to your blog will now be able to compose comments using Markdown.

Enabling Markdown for comments
Enabling Markdown for comments

Writing with Markdown

Markdown makes use of special characters and punctuation marks to indicate styles and links. The specific characters you use and how you place them in the document is key to how your document will be formatted. When the document is published, Markdown converts these special characters to the appropriate formatting. 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 instead 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, and 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.
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, this way 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 some features not originally available in Markdown, including improved support for inline HTML, code blocks, tables, and more. Code blocks can use three or more back ticks (```), 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 essentially 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 in 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.

  • Markdown Project.
  • Markdown on Wikipedia.
  • Mou is a free Markdown editor for Mac.
  • 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.
  • Draft is a Markdown editor for Android devices.
  • Simplenote is a cross-platform note-taking service by Automattic, with Markdown support.

Add Markdown support to your Custom Post Types

There are 2 options to add Markdown support to a specific Custom Post Type on your site:

  1. 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” by your Custom Post Type name.

  2. 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 );

Add Markdown support to your Custom Fields

You can follow these instructions to add Markdown support to custom meta fields.

Privacy Information

This feature 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.

Site Visitors

 

None.

Data Synced (Read More)
Site Owners / Users

 

We sync a single option that identifies whether or not the feature is activated.

Site Visitors

 

None.

Comments Off on Markdown
  • Enter your email address to follow this blog and receive news and updates from Jetpack!

    Join 110,166 other followers

  • Browse by topic