# posts

id: 5eaa6e9bd650c40e8fca96df
uuid: 49042def-04fa-434d-96e5-031c3f26a10e
title: Creating a custom theme
slug: themes
comment_id: 5eaa6e9bd650c40e8fca96df
feature_image: https://static.ghost.org/v3.0.0/images/creating-a-custom-theme.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:19
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[["soft-return","",{}]],"cards":[["image",{"src":"https://static.ghost.org/v3.0.0/images/theme-marketplace.png","caption":"Anyone can write a completely custom Ghost theme with some solid knowledge of HTML and CSS","alt":"Ghost theme marketplace screenshot"}]],"markups":[["a",["href","https://ghost.org/marketplace/"]],["code"],["a",["href","https://github.com/TryGhost/Casper"]],["a",["href","https://ghost.org/docs/api/handlebars-themes/"]],["a",["href","https://github.com/TryGhost/Starter/"]],["strong"],["a",["href","https://forum.ghost.org/c/themes"]]],"sections":[[1,"h2",[[0,[],0,"Ghost themes"]]],[1,"p",[[0,[],0,"Ghost comes with a default theme called Casper, which is designed to be a clean, readable publication layout and can be easily adapted for most purposes."]]],[1,"p",[[0,[],0,"If you need something a little more customised, it's entirely possible to build on top of existing open source themes, or to build your own from scratch. Rather than giving you a few basic settings which act as a poor proxy for code, we just let you write code."]]],[1,"h2",[[0,[],0,"Marketplace"]]],[1,"p",[[0,[],0,"There are a huge range of both free and premium pre-built themes which you can download from the "],[0,[0],1,"Ghost Theme Marketplace"],[0,[],0,":"]]],[10,0],[1,"h2",[[0,[],0,"Theme development"]]],[1,"p",[[0,[],0,"Ghost themes are written with a templating language called handlebars, which has a set of dynamic helpers to insert your data into template files. For example: "],[0,[1],1,"{{author.name}}"],[0,[],0," outputs the name of the current author."]]],[1,"p",[[0,[],0,"The best way to learn how to write your own Ghost theme is to have a look at "],[0,[2],1,"the source code for Casper"],[0,[],0,", which is heavily commented and should give you a sense of how everything fits together."],[1,[],0,0]]],[3,"ul",[[[0,[1],1,"default.hbs"],[0,[],0," is the main template file, all contexts will load inside this file unless specifically told to use a different template."]],[[0,[1],1,"post.hbs"],[0,[],0," is the file used in the context of viewing a post."]],[[0,[1],1,"index.hbs"],[0,[],0," is the file used in the context of viewing the home page."]],[[0,[],0,"and so on"]]]],[1,"p",[[0,[],0,"We've got "],[0,[3],1,"full and extensive theme documentation"],[0,[],0," which outlines every template file, context and helper that you can use. You can also get started with our useful "],[0,[4],1,"starter theme"],[0,[],0,", which includes the most common foundations and components required to build your own theme."]]],[1,"blockquote",[[0,[],0,"If you want to chat with other people making Ghost themes to get any advice or help, there's also a "],[0,[5],1,"themes"],[0,[],0," section on our "],[0,[6],1,"public Ghost forum"],[0,[],0,"."]]]]}

html:
  <h2 id="ghost-themes">Ghost themes</h2><p>Ghost comes with a default theme called Casper, which is designed to be a clean, readable publication layout and can be easily adapted for most purposes.</p><p>If you need something a little more customised, it's entirely possible to build on top of existing open source themes, or to build your own from scratch. Rather than giving you a few basic settings which act as a poor proxy for code, we just let you write code.</p><h2 id="marketplace">Marketplace</h2><p>There are a huge range of both free and premium pre-built themes which you can download from the <a href="https://ghost.org/marketplace/">Ghost Theme Marketplace</a>:</p><figure class="kg-card kg-image-card kg-card-hascaption"><img src="https://static.ghost.org/v3.0.0/images/theme-marketplace.png" class="kg-image" alt="Ghost theme marketplace screenshot"><figcaption>Anyone can write a completely custom Ghost theme with some solid knowledge of HTML and CSS</figcaption></figure><h2 id="theme-development">Theme development</h2><p>Ghost themes are written with a templating language called handlebars, which has a set of dynamic helpers to insert your data into template files. For example: <code>{{author.name}}</code> outputs the name of the current author.</p><p>The best way to learn how to write your own Ghost theme is to have a look at <a href="https://github.com/TryGhost/Casper">the source code for Casper</a>, which is heavily commented and should give you a sense of how everything fits together.<br></p><ul><li><code>default.hbs</code> is the main template file, all contexts will load inside this file unless specifically told to use a different template.</li><li><code>post.hbs</code> is the file used in the context of viewing a post.</li><li><code>index.hbs</code> is the file used in the context of viewing the home page.</li><li>and so on</li></ul><p>We've got <a href="https://ghost.org/docs/api/handlebars-themes/">full and extensive theme documentation</a> which outlines every template file, context and helper that you can use. You can also get started with our useful <a href="https://github.com/TryGhost/Starter/">starter theme</a>, which includes the most common foundations and components required to build your own theme.</p><blockquote>If you want to chat with other people making Ghost themes to get any advice or help, there's also a <strong>themes</strong> section on our <a href="https://forum.ghost.org/c/themes">public Ghost forum</a>.</blockquote>

plaintext:
  Ghost themes
  Ghost comes with a default theme called Casper, which is designed to be a clean,
  readable publication layout and can be easily adapted for most purposes.

  If you need something a little more customised, it's entirely possible to build
  on top of existing open source themes, or to build your own from scratch. Rather
  than giving you a few basic settings which act as a poor proxy for code, we just
  let you write code.

  Marketplace
  There are a huge range of both free and premium pre-built themes which you can
  download from the Ghost Theme Marketplace [https://ghost.org/marketplace/]:

  Anyone can write a completely custom Ghost theme with some solid knowledge of
  HTML and CSSTheme development
  Ghost themes are written with a templating language called handlebars, which has
  a set of dynamic helpers to insert your data into template files. For example: 
  {{author.name}} outputs the name of the current author.

  The best way to learn how to write your own Ghost theme is to have a look at 
  the
  source code for Casper [https://github.com/TryGhost/Casper], which is heavily
  commented and should give you a sense of how everything fits together.


   * default.hbs is the main template file, all contexts will load inside this
     file unless specifically told to use a different template.
   * post.hbs is the file used in the context of viewing a post.
   * index.hbs is the file used in the context of viewing the home page.
   * and so on

  We've got full and extensive theme documentation
  [https://ghost.org/docs/api/handlebars-themes/] which outlines every template
  file, context and helper that you can use. You can also get started with our
  useful starter theme [https://github.com/TryGhost/Starter/], which includes the
  most common foundations and components required to build your own theme.

  > If you want to chat with other people making Ghost themes to get any advice or
  help, there's also a themes section on our public Ghost forum
  [https://forum.ghost.org/c/themes].

custom_excerpt:
  Ghost comes with a beautiful default theme designed for publishers which can easily be adapted for most purposes, or you can build a custom theme to suit your needs.


id: 5eaa6e9bd650c40e8fca96e1
uuid: 3a46eda9-adb8-4e02-b4c6-88ddcdaed334
title: Apps & integrations
slug: apps-integrations
comment_id: 5eaa6e9bd650c40e8fca96e1
feature_image: https://static.ghost.org/v3.0.0/images/app-integrations.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:20
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[],"cards":[["image",{"src":"https://static.ghost.org/v3.0.0/images/integrations-icons.png","cardWidth":"full"}],["markdown",{"markdown":"<script src=\"https://zapier.com/apps/embed/widget.js?services=Ghost&container=true&limit=8\"></script>\n"}],["image",{"src":"https://static.ghost.org/v3.0.0/images/integrations-and-webhooks-in-ghost.png","alt":"Screenshot of custom integrations with webhooks in Ghost Admin","cardWidth":""}]],"markups":[["a",["href","https://ghost.org/integrations/"]],["a",["href","https://zapier.com"]],["strong"],["a",["href","https://ghost.org/docs/api/"]],["a",["href","/themes/"]]],"sections":[[1,"h2",[[0,[],0,"Work with your existing tools"]]],[1,"p",[[0,[],0,"It's possible to connect your Ghost site to hundreds of the most popular apps and tools using integrations that take no more than a few minutes to setup."]]],[1,"p",[[0,[],0,"Whether you need to automate workflows, connect your email list, build a community or embed products from your ecommerce store, our "],[0,[0],1,"integrations library"],[0,[],0," has got it all covered with hundreds of tutorials."]]],[10,0],[1,"h2",[[0,[],0,"Zapier"]]],[1,"p",[[0,[],0,"On top of this, you can connect your Ghost site to more than 1,000 external services using the official integration with "],[0,[1],1,"Zapier"],[0,[],0,"."]]],[1,"p",[[0,[],0,"Zapier sets up automations with Triggers and Actions, which allows you to create and customise a wide range of connected applications."]]],[1,"blockquote",[[0,[2],1,"Example"],[0,[],0,": When someone new subscribes to a newsletter on a Ghost site (Trigger) then the contact information is automatically pushed into MailChimp (Action)."]]],[1,"p",[[0,[2],1,"Here are the most popular Ghost<>Zapier automation templates:"],[0,[],0," "]]],[10,1],[1,"h2",[[0,[],0,"Custom integrations"]]],[1,"p",[[0,[],0,"At the heart of Ghost sits a robust JSON API – designed to create, manage and retrieve content with ease. "]]],[1,"p",[[0,[],0,"It's possible to create custom Ghost integrations with dedicated API keys and webhooks from the Integrations page within Ghost Admin. "]]],[10,2],[1,"p",[[0,[],0,"Beyond that, the API allows you to build entirely custom publishing apps. You can send content from your favourite desktop editor, build a custom interface for handling editorial workflow or use Ghost as a full headless CMS with a custom front-end."]]],[1,"p",[[0,[],0,"The Ghost API is "],[0,[3],1,"thoroughly documented"],[0,[],0," and straightforward to work with for developers of almost any level. "]]],[1,"h2",[[0,[],0,"Final step: Themes"]]],[1,"p",[[0,[],0,"Alright, on to the last post in our welcome-series! If you're curious about creating your own Ghost theme from scratch, "],[0,[4],1,"find out how that works"],[0,[],0,"."]]]]}

html:
  <h2 id="work-with-your-existing-tools">Work with your existing tools</h2><p>It's possible to connect your Ghost site to hundreds of the most popular apps and tools using integrations that take no more than a few minutes to setup.</p><p>Whether you need to automate workflows, connect your email list, build a community or embed products from your ecommerce store, our <a href="https://ghost.org/integrations/">integrations library</a> has got it all covered with hundreds of tutorials.</p><figure class="kg-card kg-image-card kg-width-full"><img src="https://static.ghost.org/v3.0.0/images/integrations-icons.png" class="kg-image"></figure><h2 id="zapier">Zapier</h2><p>On top of this, you can connect your Ghost site to more than 1,000 external services using the official integration with <a href="https://zapier.com">Zapier</a>.</p><p>Zapier sets up automations with Triggers and Actions, which allows you to create and customise a wide range of connected applications.</p><blockquote><strong>Example</strong>: When someone new subscribes to a newsletter on a Ghost site (Trigger) then the contact information is automatically pushed into MailChimp (Action).</blockquote><p><strong>Here are the most popular Ghost&lt;&gt;Zapier automation templates:</strong> </p><!--kg-card-begin: markdown--><script src="https://zapier.com/apps/embed/widget.js?services=Ghost&container=true&limit=8"></script>
  <!--kg-card-end: markdown--><h2 id="custom-integrations">Custom integrations</h2><p>At the heart of Ghost sits a robust JSON API – designed to create, manage and retrieve content with ease. </p><p>It's possible to create custom Ghost integrations with dedicated API keys and webhooks from the Integrations page within Ghost Admin. </p><figure class="kg-card kg-image-card"><img src="https://static.ghost.org/v3.0.0/images/integrations-and-webhooks-in-ghost.png" class="kg-image" alt="Screenshot of custom integrations with webhooks in Ghost Admin"></figure><p>Beyond that, the API allows you to build entirely custom publishing apps. You can send content from your favourite desktop editor, build a custom interface for handling editorial workflow or use Ghost as a full headless CMS with a custom front-end.</p><p>The Ghost API is <a href="https://ghost.org/docs/api/">thoroughly documented</a> and straightforward to work with for developers of almost any level. </p><h2 id="final-step-themes">Final step: Themes</h2><p>Alright, on to the last post in our welcome-series! If you're curious about creating your own Ghost theme from scratch, <a href="/themes/">find out how that works</a>.</p>

plaintext:
  Work with your existing tools
  It's possible to connect your Ghost site to hundreds of the most popular apps
  and tools using integrations that take no more than a few minutes to setup.

  Whether you need to automate workflows, connect your email list, build a
  community or embed products from your ecommerce store, our integrations library
  [https://ghost.org/integrations/] has got it all covered with hundreds of
  tutorials.

  Zapier
  On top of this, you can connect your Ghost site to more than 1,000 external
  services using the official integration with Zapier [https://zapier.com].

  Zapier sets up automations with Triggers and Actions, which allows you to create
  and customise a wide range of connected applications.

  > Example: When someone new subscribes to a newsletter on a Ghost site (Trigger)
  then the contact information is automatically pushed into MailChimp (Action).
  Here are the most popular Ghost<>Zapier automation templates: 

  Custom integrations
  At the heart of Ghost sits a robust JSON API – designed to create, manage and
  retrieve content with ease. 

  It's possible to create custom Ghost integrations with dedicated API keys and
  webhooks from the Integrations page within Ghost Admin. 

  Beyond that, the API allows you to build entirely custom publishing apps. You
  can send content from your favourite desktop editor, build a custom interface
  for handling editorial workflow or use Ghost as a full headless CMS with a
  custom front-end.

  The Ghost API is thoroughly documented [https://ghost.org/docs/api/] and
  straightforward to work with for developers of almost any level. 

  Final step: Themes
  Alright, on to the last post in our welcome-series! If you're curious about
  creating your own Ghost theme from scratch, find out how that works [/themes/].

custom_excerpt:
  Work with all your favourite apps and tools or create your own custom integrations using the Ghost API.


id: 5eaa6e9bd650c40e8fca96e3
uuid: ed327d37-2515-4735-a7f5-09dc391dfacc
title: Organising your content
slug: organising-content
comment_id: 5eaa6e9bd650c40e8fca96e3
feature_image: https://static.ghost.org/v3.0.0/images/organising-your-content.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:21
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[["soft-return","",{}]],"cards":[],"markups":[["code"],["em"],["strong"],["a",["href","https://ghost.org/docs/api/handlebars-themes/"]],["a",["href","http://yaml.org/spec/1.2/spec.html","rel","noreferrer nofollow noopener"]],["a",["href","https://ghost.org/docs/api/handlebars-themes/routing/"]],["a",["href","/apps-integrations/"]]],"sections":[[1,"h2",[[0,[],0,"Sensible tagging"]]],[1,"p",[[0,[],0,"You can think of tags like Gmail labels. By tagging posts with one or more keyword, you can organise articles into buckets of related content."]]],[1,"p",[[0,[],0,"When you create content for your publication you can assign tags to help differentiate between categories of content. "]]],[1,"p",[[0,[],0,"For example you may tag some content with News and other content with Podcast, which would create two distinct categories of content listed on "],[0,[0],1,"/tag/news/"],[0,[],0," and "],[0,[0],1,"/tag/podcast/"],[0,[],0,", respectively."]]],[1,"p",[[0,[],0,"If you tag a post with both "],[0,[0],1,"News"],[0,[],0," "],[0,[1],1,"and"],[0,[],0," "],[0,[0],1,"Podcast"],[0,[],0," - then it appears in both sections. Tag archives are like dedicated home-pages for each category of content that you have. They have their own pages, their own RSS feeds, and can support their own cover images and meta data."]]],[1,"h3",[[0,[],0,"The primary tag"]]],[1,"p",[[0,[],0,"Inside the Ghost editor, you can drag and drop tags into a specific order. The first tag in the list is always given the most importance, and some themes will only display the primary tag (the first tag in the list) by default. "]]],[1,"blockquote",[[0,[1,2],1,"News"],[0,[],1,", Technology, Startup"]]],[1,"p",[[0,[],0,"So you can add the most important tag which you want to show up in your theme, but also add related tags which are less important."]]],[1,"h3",[[0,[],0,"Private tags"]]],[1,"p",[[0,[],0,"Sometimes you may want to assign a post a specific tag, but you don't necessarily want that tag appearing in the theme or creating an archive page. In Ghost, hashtags are private and can be used for special styling."]]],[1,"p",[[0,[],0,"For example, if you sometimes publish posts with video content - you might want your theme to adapt and get rid of the sidebar for these posts, to give more space for an embedded video to fill the screen. In this case, you could use private tags to tell your theme what to do."]]],[1,"blockquote",[[0,[1,2],1,"News"],[0,[],1,", #video"]]],[1,"p",[[0,[],0,"Here, the theme would assign the post publicly displayed tags of News - but it would also keep a private record of the post being tagged with #video. In your theme, you could then look for private tags conditionally and give them special formatting. "]]],[1,"blockquote",[[0,[1],0,"You can find documentation for theme development techniques like this and many more over on Ghost's extensive "],[0,[3],1,"theme docs"],[0,[],1,"."]]],[1,"h2",[[0,[],0,"Dynamic routing"]]],[1,"p",[[0,[],0,"Dynamic routing gives you the ultimate freedom to build a custom publication to suit your needs. Routes are rules that map URL patterns to your content and templates. "]]],[1,"p",[[0,[],0,"You may not want content tagged with "],[0,[0],1,"News"],[0,[],0," to exist on: "],[0,[0],1,"example.com/tag/news"],[0,[],0,". Instead, you want it to exist on "],[0,[0],1,"example.com/news"],[0,[],0," ."]]],[1,"p",[[0,[],0,"In this case you can use dynamic routes to create customised collections of content on your site. It's also possible to use multiple templates in your theme to render each content type differently."]]],[1,"p",[[0,[],0,"There are lots of use cases for dynamic routing with Ghost, here are a few common examples: "]]],[3,"ul",[[[0,[],0,"Setting a custom home page with its own template"]],[[0,[],0,"Having separate content hubs for blog and podcast, that render differently, and have custom RSS feeds to support two types of content"]],[[0,[],0,"Creating a founders column as a unique view, by filtering content created by specific authors"]],[[0,[],0,"Including dates in permalinks for your posts"]],[[0,[],0,"Setting posts to have a URL relative to their primary tag like "],[0,[0],1,"example.com/europe/story-title/"],[1,[],0,0]]]],[1,"blockquote",[[0,[1],0,"Dynamic routing can be configured in Ghost using "],[0,[4],1,"YAML"],[0,[],0," files. Read our dynamic routing "],[0,[5],1,"documentation"],[0,[],1," for further details."]]],[1,"h2",[[0,[],0,"Next: Apps & Integrations"]]],[1,"p",[[0,[],0,"Work with all your favourite apps and tools using our "],[0,[6],1,"integrations"],[0,[],0,", or create your own custom integrations with webhooks."]]],[1,"p",[]]]}

html:
  <h2 id="sensible-tagging">Sensible tagging</h2><p>You can think of tags like Gmail labels. By tagging posts with one or more keyword, you can organise articles into buckets of related content.</p><p>When you create content for your publication you can assign tags to help differentiate between categories of content. </p><p>For example you may tag some content with News and other content with Podcast, which would create two distinct categories of content listed on <code>/tag/news/</code> and <code>/tag/podcast/</code>, respectively.</p><p>If you tag a post with both <code>News</code> <em>and</em> <code>Podcast</code> - then it appears in both sections. Tag archives are like dedicated home-pages for each category of content that you have. They have their own pages, their own RSS feeds, and can support their own cover images and meta data.</p><h3 id="the-primary-tag">The primary tag</h3><p>Inside the Ghost editor, you can drag and drop tags into a specific order. The first tag in the list is always given the most importance, and some themes will only display the primary tag (the first tag in the list) by default. </p><blockquote><em><strong>News</strong>, Technology, Startup</em></blockquote><p>So you can add the most important tag which you want to show up in your theme, but also add related tags which are less important.</p><h3 id="private-tags">Private tags</h3><p>Sometimes you may want to assign a post a specific tag, but you don't necessarily want that tag appearing in the theme or creating an archive page. In Ghost, hashtags are private and can be used for special styling.</p><p>For example, if you sometimes publish posts with video content - you might want your theme to adapt and get rid of the sidebar for these posts, to give more space for an embedded video to fill the screen. In this case, you could use private tags to tell your theme what to do.</p><blockquote><em><strong>News</strong>, #video</em></blockquote><p>Here, the theme would assign the post publicly displayed tags of News - but it would also keep a private record of the post being tagged with #video. In your theme, you could then look for private tags conditionally and give them special formatting. </p><blockquote><em>You can find documentation for theme development techniques like this and many more over on Ghost's extensive <a href="https://ghost.org/docs/api/handlebars-themes/">theme docs</a>.</em></blockquote><h2 id="dynamic-routing">Dynamic routing</h2><p>Dynamic routing gives you the ultimate freedom to build a custom publication to suit your needs. Routes are rules that map URL patterns to your content and templates. </p><p>You may not want content tagged with <code>News</code> to exist on: <code>example.com/tag/news</code>. Instead, you want it to exist on <code>example.com/news</code> .</p><p>In this case you can use dynamic routes to create customised collections of content on your site. It's also possible to use multiple templates in your theme to render each content type differently.</p><p>There are lots of use cases for dynamic routing with Ghost, here are a few common examples: </p><ul><li>Setting a custom home page with its own template</li><li>Having separate content hubs for blog and podcast, that render differently, and have custom RSS feeds to support two types of content</li><li>Creating a founders column as a unique view, by filtering content created by specific authors</li><li>Including dates in permalinks for your posts</li><li>Setting posts to have a URL relative to their primary tag like <code>example.com/europe/story-title/</code><br></li></ul><blockquote><em>Dynamic routing can be configured in Ghost using <a href="http://yaml.org/spec/1.2/spec.html" rel="noreferrer nofollow noopener">YAML</a> files. Read our dynamic routing <a href="https://ghost.org/docs/api/handlebars-themes/routing/">documentation</a> for further details.</em></blockquote><h2 id="next-apps-integrations">Next: Apps &amp; Integrations</h2><p>Work with all your favourite apps and tools using our <a href="/apps-integrations/">integrations</a>, or create your own custom integrations with webhooks.</p>

plaintext:
  Sensible tagging
  You can think of tags like Gmail labels. By tagging posts with one or more
  keyword, you can organise articles into buckets of related content.

  When you create content for your publication you can assign tags to help
  differentiate between categories of content. 

  For example you may tag some content with News and other content with Podcast,
  which would create two distinct categories of content listed on /tag/news/ and 
  /tag/podcast/, respectively.

  If you tag a post with both News and Podcast - then it appears in both sections.
  Tag archives are like dedicated home-pages for each category of content that you
  have. They have their own pages, their own RSS feeds, and can support their own
  cover images and meta data.

  The primary tag
  Inside the Ghost editor, you can drag and drop tags into a specific order. The
  first tag in the list is always given the most importance, and some themes will
  only display the primary tag (the first tag in the list) by default. 

  > News, Technology, Startup
  So you can add the most important tag which you want to show up in your theme,
  but also add related tags which are less important.

  Private tags
  Sometimes you may want to assign a post a specific tag, but you don't
  necessarily want that tag appearing in the theme or creating an archive page. In
  Ghost, hashtags are private and can be used for special styling.

  For example, if you sometimes publish posts with video content - you might want
  your theme to adapt and get rid of the sidebar for these posts, to give more
  space for an embedded video to fill the screen. In this case, you could use
  private tags to tell your theme what to do.

  > News, #video
  Here, the theme would assign the post publicly displayed tags of News - but it
  would also keep a private record of the post being tagged with #video. In your
  theme, you could then look for private tags conditionally and give them special
  formatting. 

  > You can find documentation for theme development techniques like this and many
  more over on Ghost's extensive theme docs
  [https://ghost.org/docs/api/handlebars-themes/].
  Dynamic routing
  Dynamic routing gives you the ultimate freedom to build a custom publication to
  suit your needs. Routes are rules that map URL patterns to your content and
  templates. 

  You may not want content tagged with News to exist on: example.com/tag/news.
  Instead, you want it to exist on example.com/news .

  In this case you can use dynamic routes to create customised collections of
  content on your site. It's also possible to use multiple templates in your theme
  to render each content type differently.

  There are lots of use cases for dynamic routing with Ghost, here are a few
  common examples: 

   * Setting a custom home page with its own template
   * Having separate content hubs for blog and podcast, that render differently,
     and have custom RSS feeds to support two types of content
   * Creating a founders column as a unique view, by filtering content created by
     specific authors
   * Including dates in permalinks for your posts
   * Setting posts to have a URL relative to their primary tag like 
     example.com/europe/story-title/
     

  > Dynamic routing can be configured in Ghost using YAML
  [http://yaml.org/spec/1.2/spec.html] files. Read our dynamic routing 
  documentation [https://ghost.org/docs/api/handlebars-themes/routing/] for
  further details.
  Next: Apps & Integrations
  Work with all your favourite apps and tools using our integrations
  [/apps-integrations/], or create your own custom integrations with webhooks.

custom_excerpt:
  Ghost has a flexible organisational taxonomy called tags and the ability to create custom site structures using dynamic routes.


id: 5eaa6e9bd650c40e8fca96e5
uuid: 52c92cb5-82ef-45d1-bd91-5968960393be
title: Managing admin settings
slug: admin-settings
comment_id: 5eaa6e9bd650c40e8fca96e5
feature_image: https://static.ghost.org/v3.0.0/images/admin-settings.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:22
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[["soft-return","",{}],["soft-return","",{}],["soft-return","",{}],["soft-return","",{}],["soft-return","",{}],["soft-return","",{}],["soft-return","",{}]],"cards":[["image",{"src":"https://static.ghost.org/v1.0.0/images/private.png"}]],"markups":[["em"],["strong"],["a",["href","https://ghost.org/pricing/"]],["a",["href","/organising-content/"]]],"sections":[[1,"h2",[[0,[],0,"Make your site private"]]],[1,"p",[[0,[],0,"If you've got a publication that you don't want the world to see yet because it's not ready to launch, you can hide your Ghost site behind a basic shared pass-phrase."]]],[1,"p",[[0,[],0,"You can toggle this preference on at the bottom of Ghost's General Settings:"]]],[10,0],[1,"p",[[0,[],0,"Ghost will give you a short, randomly generated pass-phrase which you can share with anyone who needs access to the site while you're working on it. While this setting is enabled, all search engine optimisation features will be switched off to help keep your site under the radar."]]],[1,"p",[[0,[],0,"Do remember though, this is "],[0,[0],1,"not"],[0,[],0," secure authentication. You shouldn't rely on this feature for protecting important private data. It's just a simple, shared pass-phrase for some very basic privacy."]]],[1,"h2",[[0,[],0,"Invite your team "]]],[1,"p",[[0,[],0,"Ghost has a number of different user roles for your team:"]]],[1,"p",[[0,[1],1,"Contributors"],[1,[],0,0],[0,[],0,"This is the base user level in Ghost. Contributors can create and edit their own draft posts, but they are unable to edit drafts of others or publish posts. Contributors are "],[0,[1],1,"untrusted"],[0,[],0," users with the most basic access to your publication."]]],[1,"p",[[0,[1],1,"Authors"],[1,[],0,1],[0,[],0,"Authors are the 2nd user level in Ghost. Authors can write, edit  and publish their own posts. Authors are "],[0,[1],1,"trusted"],[0,[],0," users. If you don't trust users to be allowed to publish their own posts, they should be set as Contributors."]]],[1,"p",[[0,[1],1,"Editors"],[1,[],0,2],[0,[],0,"Editors are the 3rd user level in Ghost. Editors can do everything that an Author can do, but they can also edit and publish the posts of others - as well as their own. Editors can also invite new Contributors & Authors to the site."]]],[1,"p",[[0,[1],1,"Administrators"],[1,[],0,3],[0,[],0,"The top user level in Ghost is Administrator. Again, administrators can do everything that Authors and Editors can do, but they can also edit all site settings and data, not just content. Additionally, administrators have full access to invite, manage or remove any other user of the site."],[1,[],0,4],[1,[],0,5],[0,[1],1,"The Owner"],[1,[],0,6],[0,[],0,"There is only ever one owner of a Ghost site. The owner is a special user which has all the same permissions as an Administrator, but with two exceptions: The Owner can never be deleted. And in some circumstances the owner will have access to additional special settings if applicable. For example: billing details, if using "],[0,[2,1],2,"Ghost(Pro)"],[0,[],0,"."]]],[1,"blockquote",[[0,[0],1,"It's a good idea to ask all of your users to fill out their user profiles, including bio and social links. These will populate rich structured data for posts and generally create more opportunities for themes to fully populate their design."]]],[1,"h2",[[0,[],0,"Next: Organising content"]]],[1,"p",[[0,[],0,"Find out how to "],[0,[3],1,"organise your content"],[0,[],0," with sensible tags and authors, or for more advanced configurations, how to create custom content structures using dynamic routing."]]]]}

html:
  <h2 id="make-your-site-private">Make your site private</h2><p>If you've got a publication that you don't want the world to see yet because it's not ready to launch, you can hide your Ghost site behind a basic shared pass-phrase.</p><p>You can toggle this preference on at the bottom of Ghost's General Settings:</p><figure class="kg-card kg-image-card"><img src="https://static.ghost.org/v1.0.0/images/private.png" class="kg-image"></figure><p>Ghost will give you a short, randomly generated pass-phrase which you can share with anyone who needs access to the site while you're working on it. While this setting is enabled, all search engine optimisation features will be switched off to help keep your site under the radar.</p><p>Do remember though, this is <em>not</em> secure authentication. You shouldn't rely on this feature for protecting important private data. It's just a simple, shared pass-phrase for some very basic privacy.</p><h2 id="invite-your-team">Invite your team </h2><p>Ghost has a number of different user roles for your team:</p><p><strong>Contributors</strong><br>This is the base user level in Ghost. Contributors can create and edit their own draft posts, but they are unable to edit drafts of others or publish posts. Contributors are <strong>untrusted</strong> users with the most basic access to your publication.</p><p><strong>Authors</strong><br>Authors are the 2nd user level in Ghost. Authors can write, edit  and publish their own posts. Authors are <strong>trusted</strong> users. If you don't trust users to be allowed to publish their own posts, they should be set as Contributors.</p><p><strong>Editors</strong><br>Editors are the 3rd user level in Ghost. Editors can do everything that an Author can do, but they can also edit and publish the posts of others - as well as their own. Editors can also invite new Contributors &amp; Authors to the site.</p><p><strong>Administrators</strong><br>The top user level in Ghost is Administrator. Again, administrators can do everything that Authors and Editors can do, but they can also edit all site settings and data, not just content. Additionally, administrators have full access to invite, manage or remove any other user of the site.<br><br><strong>The Owner</strong><br>There is only ever one owner of a Ghost site. The owner is a special user which has all the same permissions as an Administrator, but with two exceptions: The Owner can never be deleted. And in some circumstances the owner will have access to additional special settings if applicable. For example: billing details, if using <a href="https://ghost.org/pricing/"><strong>Ghost(Pro)</strong></a>.</p><blockquote><em>It's a good idea to ask all of your users to fill out their user profiles, including bio and social links. These will populate rich structured data for posts and generally create more opportunities for themes to fully populate their design.</em></blockquote><h2 id="next-organising-content">Next: Organising content</h2><p>Find out how to <a href="/organising-content/">organise your content</a> with sensible tags and authors, or for more advanced configurations, how to create custom content structures using dynamic routing.</p>

plaintext:
  Make your site private
  If you've got a publication that you don't want the world to see yet because
  it's not ready to launch, you can hide your Ghost site behind a basic shared
  pass-phrase.

  You can toggle this preference on at the bottom of Ghost's General Settings:

  Ghost will give you a short, randomly generated pass-phrase which you can share
  with anyone who needs access to the site while you're working on it. While this
  setting is enabled, all search engine optimisation features will be switched off
  to help keep your site under the radar.

  Do remember though, this is not secure authentication. You shouldn't rely on
  this feature for protecting important private data. It's just a simple, shared
  pass-phrase for some very basic privacy.

  Invite your team 
  Ghost has a number of different user roles for your team:

  Contributors
  This is the base user level in Ghost. Contributors can create and edit their own
  draft posts, but they are unable to edit drafts of others or publish posts.
  Contributors are untrusted users with the most basic access to your publication.

  Authors
  Authors are the 2nd user level in Ghost. Authors can write, edit  and publish
  their own posts. Authors are trusted users. If you don't trust users to be
  allowed to publish their own posts, they should be set as Contributors.

  Editors
  Editors are the 3rd user level in Ghost. Editors can do everything that an
  Author can do, but they can also edit and publish the posts of others - as well
  as their own. Editors can also invite new Contributors & Authors to the site.

  Administrators
  The top user level in Ghost is Administrator. Again, administrators can do
  everything that Authors and Editors can do, but they can also edit all site
  settings and data, not just content. Additionally, administrators have full
  access to invite, manage or remove any other user of the site.

  The Owner
  There is only ever one owner of a Ghost site. The owner is a special user which
  has all the same permissions as an Administrator, but with two exceptions: The
  Owner can never be deleted. And in some circumstances the owner will have access
  to additional special settings if applicable. For example: billing details, if
  using Ghost(Pro) [https://ghost.org/pricing/].

  > It's a good idea to ask all of your users to fill out their user profiles,
  including bio and social links. These will populate rich structured data for
  posts and generally create more opportunities for themes to fully populate their
  design.
  Next: Organising content
  Find out how to organise your content [/organising-content/] with sensible tags
  and authors, or for more advanced configurations, how to create custom content
  structures using dynamic routing.

custom_excerpt:
  There are a couple of things to do next while you're getting set up: making your site private and inviting your team.


id: 5eaa6e9bd650c40e8fca96e7
uuid: d7bc53bd-bf27-46d6-a94e-2389cdc47332
title: Publishing options
slug: publishing-options
comment_id: 5eaa6e9bd650c40e8fca96e7
feature_image: https://static.ghost.org/v3.0.0/images/publishing-options.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:23
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[],"cards":[["code",{"code":"{\n    \"@context\": \"https://schema.org\",\n    \"@type\": \"Article\",\n    \"publisher\": {\n        \"@type\": \"Organization\",\n        \"name\": \"Publishing options\",\n        \"logo\": \"https://static.ghost.org/ghost-logo.svg\"\n    },\n    \"author\": {\n        \"@type\": \"Person\",\n        \"name\": \"Ghost\",\n        \"url\": \"http://demo.ghost.io/author/ghost/\",\n        \"sameAs\": []\n    },\n    \"headline\": \"Publishing options\",\n    \"url\": \"http://demo.ghost.io/publishing-options\",\n    \"datePublished\": \"2018-08-08T11:44:00.000Z\",\n    \"dateModified\": \"2018-08-09T12:06:21.000Z\",\n    \"keywords\": \"Getting Started\",\n    \"description\": \"The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page.\",\n    }\n}\n    "}]],"markups":[["strong"],["a",["href","https://schema.org/"]],["a",["href","https://search.google.com/structured-data/testing-tool","rel","noreferrer nofollow noopener"]],["a",["href","/admin-settings/"]]],"sections":[[1,"h2",[[0,[],0,"Distribute your content"]]],[1,"p",[[0,[],0,"Access the post settings menu by clicking the settings icon in the top right hand corner of the editor and discover everything you need to get your content ready for publishing. This is where you can edit things like tags, post URL, publish date and custom meta data."]]],[1,"h2",[[0,[],0,"Feature images, URL & excerpts"]]],[1,"p",[[0,[],0,"Insert your post feature image from the very top of the post settings menu. Consider resizing or optimising your image first to ensure it's an appropriate size. Below this, you can set your post URL, publish date and add a custom excerpt."]]],[1,"h2",[[0,[],0,"Tags & authors"]]],[1,"p",[[0,[],0,"You can easily add multiple tags and authors to any post to filter and organise the relationships between your content in Ghost."]]],[1,"h2",[[0,[],0,"Structured data & SEO"]]],[1,"p",[[0,[],0,"There's no need to hard code your meta data. In fact, Ghost will generate default meta data automatically using the content in your post."]]],[1,"p",[[0,[],0,"Alternatively, you can override this by adding a custom meta title and description, as well as unique information for social media sharing cards on Facebook and Twitter."]]],[1,"p",[[0,[],0,"It's also possible to set custom canonicals, which is useful for guest posts or curated lists of external links."]]],[1,"p",[[0,[],0,"Ghost will automatically implement "],[0,[0],1,"structured data"],[0,[],0," for your publication using JSON-LD to further optimise your content."]]],[10,0],[1,"p",[[0,[],0,"You can test that the structured data "],[0,[1],1,"schema"],[0,[],0," on your site is working as it should using "],[0,[2],1,"Google’s structured data tool"],[0,[],0,". "]]],[1,"h2",[[0,[],0,"Code injection"]]],[1,"p",[[0,[],0,"This tool allows you to inject code on a per post or page basis, or across your entire site. This means you can modify CSS, add unique tracking codes, or add other scripts to the head or foot of your publication without making edits to your theme files. "]]],[1,"p",[[0,[0],1,"To add code site-wide"],[0,[],0,", use the code injection tool in the main admin menu. This is useful for adding a Google Analytics tracking code, or to start tracking with any other analytics tool."]]],[1,"p",[[0,[0],1,"To add code to a post or page"],[0,[],0,", use the code injection tool within the post settings menu. This is useful if you want to add art direction, scripts or styles that are only applicable to one post or page."]]],[1,"h2",[[0,[],0,"Next: Admin settings"]]],[1,"p",[[0,[],0,"Now you understand how to create and optimise content, let's explore some "],[0,[3],1,"admin settings"],[0,[],0," so you can invite your team and start collaborating."]]]]}

html:
  <h2 id="distribute-your-content">Distribute your content</h2><p>Access the post settings menu by clicking the settings icon in the top right hand corner of the editor and discover everything you need to get your content ready for publishing. This is where you can edit things like tags, post URL, publish date and custom meta data.</p><h2 id="feature-images-url-excerpts">Feature images, URL &amp; excerpts</h2><p>Insert your post feature image from the very top of the post settings menu. Consider resizing or optimising your image first to ensure it's an appropriate size. Below this, you can set your post URL, publish date and add a custom excerpt.</p><h2 id="tags-authors">Tags &amp; authors</h2><p>You can easily add multiple tags and authors to any post to filter and organise the relationships between your content in Ghost.</p><h2 id="structured-data-seo">Structured data &amp; SEO</h2><p>There's no need to hard code your meta data. In fact, Ghost will generate default meta data automatically using the content in your post.</p><p>Alternatively, you can override this by adding a custom meta title and description, as well as unique information for social media sharing cards on Facebook and Twitter.</p><p>It's also possible to set custom canonicals, which is useful for guest posts or curated lists of external links.</p><p>Ghost will automatically implement <strong>structured data</strong> for your publication using JSON-LD to further optimise your content.</p><pre><code>{
      "@context": "https://schema.org",
      "@type": "Article",
      "publisher": {
          "@type": "Organization",
          "name": "Publishing options",
          "logo": "https://static.ghost.org/ghost-logo.svg"
      },
      "author": {
          "@type": "Person",
          "name": "Ghost",
          "url": "http://demo.ghost.io/author/ghost/",
          "sameAs": []
      },
      "headline": "Publishing options",
      "url": "http://demo.ghost.io/publishing-options",
      "datePublished": "2018-08-08T11:44:00.000Z",
      "dateModified": "2018-08-09T12:06:21.000Z",
      "keywords": "Getting Started",
      "description": "The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page.",
      }
  }
      </code></pre><p>You can test that the structured data <a href="https://schema.org/">schema</a> on your site is working as it should using <a href="https://search.google.com/structured-data/testing-tool" rel="noreferrer nofollow noopener">Google’s structured data tool</a>. </p><h2 id="code-injection">Code injection</h2><p>This tool allows you to inject code on a per post or page basis, or across your entire site. This means you can modify CSS, add unique tracking codes, or add other scripts to the head or foot of your publication without making edits to your theme files. </p><p><strong>To add code site-wide</strong>, use the code injection tool in the main admin menu. This is useful for adding a Google Analytics tracking code, or to start tracking with any other analytics tool.</p><p><strong>To add code to a post or page</strong>, use the code injection tool within the post settings menu. This is useful if you want to add art direction, scripts or styles that are only applicable to one post or page.</p><h2 id="next-admin-settings">Next: Admin settings</h2><p>Now you understand how to create and optimise content, let's explore some <a href="/admin-settings/">admin settings</a> so you can invite your team and start collaborating.</p>

plaintext:
  Distribute your content
  Access the post settings menu by clicking the settings icon in the top right
  hand corner of the editor and discover everything you need to get your content
  ready for publishing. This is where you can edit things like tags, post URL,
  publish date and custom meta data.

  Feature images, URL & excerpts
  Insert your post feature image from the very top of the post settings menu.
  Consider resizing or optimising your image first to ensure it's an appropriate
  size. Below this, you can set your post URL, publish date and add a custom
  excerpt.

  Tags & authors
  You can easily add multiple tags and authors to any post to filter and organise
  the relationships between your content in Ghost.

  Structured data & SEO
  There's no need to hard code your meta data. In fact, Ghost will generate
  default meta data automatically using the content in your post.

  Alternatively, you can override this by adding a custom meta title and
  description, as well as unique information for social media sharing cards on
  Facebook and Twitter.

  It's also possible to set custom canonicals, which is useful for guest posts or
  curated lists of external links.

  Ghost will automatically implement structured data for your publication using
  JSON-LD to further optimise your content.

  {
      "@context": "https://schema.org",
      "@type": "Article",
      "publisher": {
          "@type": "Organization",
          "name": "Publishing options",
          "logo": "https://static.ghost.org/ghost-logo.svg"
      },
      "author": {
          "@type": "Person",
          "name": "Ghost",
          "url": "http://demo.ghost.io/author/ghost/",
          "sameAs": []
      },
      "headline": "Publishing options",
      "url": "http://demo.ghost.io/publishing-options",
      "datePublished": "2018-08-08T11:44:00.000Z",
      "dateModified": "2018-08-09T12:06:21.000Z",
      "keywords": "Getting Started",
      "description": "The Ghost editor has everything you need to fully optimise your content. This is where you can add tags and authors, feature a post, or turn a post into a page.",
      }
  }
      

  You can test that the structured data schema [https://schema.org/] on your site
  is working as it should using Google’s structured data tool
  [https://search.google.com/structured-data/testing-tool]. 

  Code injection
  This tool allows you to inject code on a per post or page basis, or across your
  entire site. This means you can modify CSS, add unique tracking codes, or add
  other scripts to the head or foot of your publication without making edits to
  your theme files. 

  To add code site-wide, use the code injection tool in the main admin menu. This
  is useful for adding a Google Analytics tracking code, or to start tracking with
  any other analytics tool.

  To add code to a post or page, use the code injection tool within the post
  settings menu. This is useful if you want to add art direction, scripts or
  styles that are only applicable to one post or page.

  Next: Admin settings
  Now you understand how to create and optimise content, let's explore some admin
  settings [/admin-settings/] so you can invite your team and start collaborating.

custom_excerpt:
  The Ghost editor post settings menu has everything you need to fully optimise and distribute your content effectively.


id: 5eaa6e9bd650c40e8fca96e9
uuid: 1145a747-6f65-47cc-bb30-fb5373cd8f72
title: Writing posts with Ghost ✍️
slug: the-editor
comment_id: 5eaa6e9bd650c40e8fca96e9
feature_image: https://static.ghost.org/v3.0.0/images/writing-posts-with-ghost.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:24
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[],"cards":[["image",{"src":"https://static.ghost.org/v2.0.0/images/formatting-editor-demo.gif"}],["code",{"code":"<header class=\"site-header outer\">\n    <div class=\"inner\">\n        {{> \"site-nav\"}}\n    </div>\n</header>"}],["bookmark",{"type":"bookmark","url":"https://ghost.org/","metadata":{"url":"https://ghost.org","title":"Ghost: The #1 open source headless Node.js CMS","description":"The world’s most popular modern open source publishing platform. A headless Node.js CMS used by Apple, Sky News, Tinder and thousands more. MIT licensed, with 30k+ stars on Github.","author":null,"publisher":"Ghost","thumbnail":"https://ghost.org/images/meta/Ghost.png","icon":"https://ghost.org/icons/icon-512x512.png?v=188b8b6d743c6338ba2eab2e35bab4f5"}}],["image",{"src":"https://static.ghost.org/v3.0.0/images/image-sizes-ghost-editor.png"}],["gallery",{"images":[{"fileName":"gallery-sample-1.jpg","row":0,"width":6000,"height":4000,"src":"https://static.ghost.org/v3.0.0/images/gallery-sample-1.jpg"},{"fileName":"gallery-sample-2.jpg","row":0,"width":5746,"height":3831,"src":"https://static.ghost.org/v3.0.0/images/gallery-sample-2.jpg"},{"fileName":"gallery-sample-3.jpg","row":0,"width":5872,"height":3915,"src":"https://static.ghost.org/v3.0.0/images/gallery-sample-3.jpg"}]}]],"markups":[["strong"],["code"],["a",["href","/publishing-options/"]]],"sections":[[1,"h2",[[0,[],0,"Just start writing"]]],[1,"p",[[0,[],0,"Ghost has a powerful visual editor with familiar formatting options, as well as the ability to add dynamic content."]]],[1,"p",[[0,[],0,"Select your text to add formatting such as headers or to create links. Or use Markdown shortcuts to do the work for you - if that's your thing. "]]],[10,0],[1,"h2",[[0,[],0,"Rich editing at your fingertips"]]],[1,"p",[[0,[],0,"The editor can also handle rich media objects, called "],[0,[0],1,"cards"],[0,[],0,", which can be organised and re-ordered using drag and drop. "]]],[1,"p",[[0,[],0,"You can insert a card either by clicking the  "],[0,[1],1,"+"],[0,[],0,"  button, or typing  "],[0,[1],1,"/"],[0,[],0,"  on a new line to search for a particular card. This allows you to efficiently insert"],[0,[0],1," images"],[0,[],0,", "],[0,[0],1,"markdown"],[0,[],0,", "],[0,[0],1,"html, embeds "],[0,[],0,"and more."]]],[1,"p",[[0,[0],1,"For example"],[0,[],0,":"]]],[3,"ul",[[[0,[],0,"Insert a video from YouTube directly by pasting the URL"]],[[0,[],0,"Create unique content like buttons or forms using the HTML card"]],[[0,[],0,"Need to share some code? Embed code blocks directly "]]]],[10,1],[1,"p",[[0,[],0,"It's also possible to share links from across the web in a visual way using bookmark cards that automatically render information from a websites meta data. Paste any URL to try it out: "]]],[10,2],[1,"h2",[[0,[],0,"Working with images in posts"]]],[1,"p",[[0,[],0,"You can add images to your posts in many ways:"]]],[3,"ul",[[[0,[],0,"Upload from your computer"]],[[0,[],0,"Click and drag an image into the browser"]],[[0,[],0,"Paste directly into the editor from your clipboard"]],[[0,[],0,"Insert using a URL"]]]],[1,"h3",[[0,[],0,"Image sizes"]]],[1,"p",[[0,[],0,"Once inserted you can blend images beautifully into your content at different sizes and add captions and alt tags wherever needed."]]],[10,3],[1,"h3",[[0,[],0,"Image galleries"]]],[1,"p",[[0,[],0,"Tell visual stories using the gallery card to add up to 9 images that will display as a responsive image gallery: "]]],[10,4],[1,"h3",[[0,[],0,"Image optimisation"]]],[1,"p",[[0,[],0,"Ghost will automatically resize and optimise your images with lossless compression. Your posts will be fully optimised for the web without any extra effort on your part."]]],[1,"h2",[[0,[],0,"Next: Publishing Options"]]],[1,"p",[[0,[],0,"Once your post is looking good, you'll want to use the "],[0,[2],1,"publishing options"],[0,[],0," to ensure it gets distributed in the right places, with custom meta data, feature images and more."]]],[1,"p",[]]]}

html:
  <h2 id="just-start-writing">Just start writing</h2><p>Ghost has a powerful visual editor with familiar formatting options, as well as the ability to add dynamic content.</p><p>Select your text to add formatting such as headers or to create links. Or use Markdown shortcuts to do the work for you - if that's your thing. </p><figure class="kg-card kg-image-card"><img src="https://static.ghost.org/v2.0.0/images/formatting-editor-demo.gif" class="kg-image"></figure><h2 id="rich-editing-at-your-fingertips">Rich editing at your fingertips</h2><p>The editor can also handle rich media objects, called <strong>cards</strong>, which can be organised and re-ordered using drag and drop. </p><p>You can insert a card either by clicking the  <code>+</code>  button, or typing  <code>/</code>  on a new line to search for a particular card. This allows you to efficiently insert<strong> images</strong>, <strong>markdown</strong>, <strong>html, embeds </strong>and more.</p><p><strong>For example</strong>:</p><ul><li>Insert a video from YouTube directly by pasting the URL</li><li>Create unique content like buttons or forms using the HTML card</li><li>Need to share some code? Embed code blocks directly </li></ul><pre><code>&lt;header class="site-header outer"&gt;
      &lt;div class="inner"&gt;
          {{&gt; "site-nav"}}
      &lt;/div&gt;
  &lt;/header&gt;</code></pre><p>It's also possible to share links from across the web in a visual way using bookmark cards that automatically render information from a websites meta data. Paste any URL to try it out: </p><figure class="kg-card kg-bookmark-card"><a class="kg-bookmark-container" href="https://ghost.org"><div class="kg-bookmark-content"><div class="kg-bookmark-title">Ghost: The #1 open source headless Node.js CMS</div><div class="kg-bookmark-description">The world’s most popular modern open source publishing platform. A headless Node.js CMS used by Apple, Sky News, Tinder and thousands more. MIT licensed, with 30k+ stars on Github.</div><div class="kg-bookmark-metadata"><img class="kg-bookmark-icon" src="https://ghost.org/icons/icon-512x512.png?v=188b8b6d743c6338ba2eab2e35bab4f5"><span class="kg-bookmark-publisher">Ghost</span></div></div><div class="kg-bookmark-thumbnail"><img src="https://ghost.org/images/meta/Ghost.png"></div></a></figure><h2 id="working-with-images-in-posts">Working with images in posts</h2><p>You can add images to your posts in many ways:</p><ul><li>Upload from your computer</li><li>Click and drag an image into the browser</li><li>Paste directly into the editor from your clipboard</li><li>Insert using a URL</li></ul><h3 id="image-sizes">Image sizes</h3><p>Once inserted you can blend images beautifully into your content at different sizes and add captions and alt tags wherever needed.</p><figure class="kg-card kg-image-card"><img src="https://static.ghost.org/v3.0.0/images/image-sizes-ghost-editor.png" class="kg-image"></figure><h3 id="image-galleries">Image galleries</h3><p>Tell visual stories using the gallery card to add up to 9 images that will display as a responsive image gallery: </p><figure class="kg-card kg-gallery-card kg-width-wide"><div class="kg-gallery-container"><div class="kg-gallery-row"><div class="kg-gallery-image"><img src="https://static.ghost.org/v3.0.0/images/gallery-sample-1.jpg" width="6000" height="4000"></div><div class="kg-gallery-image"><img src="https://static.ghost.org/v3.0.0/images/gallery-sample-2.jpg" width="5746" height="3831"></div><div class="kg-gallery-image"><img src="https://static.ghost.org/v3.0.0/images/gallery-sample-3.jpg" width="5872" height="3915"></div></div></div></figure><h3 id="image-optimisation">Image optimisation</h3><p>Ghost will automatically resize and optimise your images with lossless compression. Your posts will be fully optimised for the web without any extra effort on your part.</p><h2 id="next-publishing-options">Next: Publishing Options</h2><p>Once your post is looking good, you'll want to use the <a href="/publishing-options/">publishing options</a> to ensure it gets distributed in the right places, with custom meta data, feature images and more.</p>

plaintext:
  Just start writing
  Ghost has a powerful visual editor with familiar formatting options, as well as
  the ability to add dynamic content.

  Select your text to add formatting such as headers or to create links. Or use
  Markdown shortcuts to do the work for you - if that's your thing. 

  Rich editing at your fingertips
  The editor can also handle rich media objects, called cards, which can be
  organised and re-ordered using drag and drop. 

  You can insert a card either by clicking the+ button, or typing/ on a new line
  to search for a particular card. This allows you to efficiently insert images, 
  markdown, html, embeds and more.

  For example:

   * Insert a video from YouTube directly by pasting the URL
   * Create unique content like buttons or forms using the HTML card
   * Need to share some code? Embed code blocks directly 

  <header class="site-header outer">
      <div class="inner">
          {{> "site-nav"}}
      </div>
  </header>

  It's also possible to share links from across the web in a visual way using
  bookmark cards that automatically render information from a websites meta data.
  Paste any URL to try it out: 

  Ghost: The #1 open source headless Node.js CMSThe world’s most popular modern
  open source publishing platform. A headless Node.js CMS used by Apple, Sky
  News,
  Tinder and thousands more. MIT licensed, with 30k+ stars on Github.Ghost
  [https://ghost.org]Working with images in posts
  You can add images to your posts in many ways:

   * Upload from your computer
   * Click and drag an image into the browser
   * Paste directly into the editor from your clipboard
   * Insert using a URL

  Image sizes
  Once inserted you can blend images beautifully into your content at different
  sizes and add captions and alt tags wherever needed.

  Image galleries
  Tell visual stories using the gallery card to add up to 9 images that will
  display as a responsive image gallery: 

  Image optimisation
  Ghost will automatically resize and optimise your images with lossless
  compression. Your posts will be fully optimised for the web without any extra
  effort on your part.

  Next: Publishing Options
  Once your post is looking good, you'll want to use the publishing options
  [/publishing-options/] to ensure it gets distributed in the right places, with
  custom meta data, feature images and more.

custom_excerpt:
  Discover familiar formatting options in a functional toolbar and the ability to add dynamic content seamlessly.


id: 5eaa6e9bd650c40e8fca96eb
uuid: 7e793e28-78e8-4a02-bbbb-c8404feb6423
title: Welcome to Ghost
slug: welcome
comment_id: 5eaa6e9bd650c40e8fca96eb
feature_image: https://static.ghost.org/v3.0.0/images/welcome-to-ghost.png
type: post
status: published
visibility: public
author_id: 5951f5fca366002ebd5dbef7
created_at: 2020-04-30 06:22:19
created_by: 1
updated_at: 2020-04-30 06:22:19
updated_by: 1
published_at: 2020-04-30 06:22:25
published_by: 1
mobiledoc:
  {"version":"0.3.1","atoms":[],"cards":[],"markups":[["strong"],["a",["href","https://ghost.org/integrations/"]],["a",["href","https://ghost.org/pricing"]],["a",["href","https://github.com/TryGhost"]],["a",["href","/the-editor/"]]],"sections":[[1,"h2",[[0,[0],1,"A few things you should know"]]],[3,"ol",[[[0,[],0,"Ghost is designed for ambitious, professional publishers who want to actively build a business around their content. That's who it works best for. "]],[[0,[],0,"The entire platform can be modified and customised to suit your needs. It's very powerful, but does require some knowledge of code. Ghost is not necessarily a good platform for beginners or people who just want a simple personal blog. "]],[[0,[],0,"It's possible to work with all your favourite tools and apps with hundreds of "],[0,[1],1,"integrations"],[0,[],0," to speed up your workflows, connect email lists, build communities and much more."]]]],[1,"h2",[[0,[],0,"Behind the scenes"]]],[1,"p",[[0,[],0,"Ghost is made by an independent non-profit organisation called the Ghost Foundation. We are 100% self funded by revenue from our "],[0,[2],1,"Ghost(Pro)"],[0,[],0," service, and every penny we make is re-invested into funding further development of free, open source technology for modern publishing."]]],[1,"p",[[0,[],0,"The version of Ghost you are looking at right now would not have been made possible without generous contributions from the open source "],[0,[3],1,"community"],[0,[],0,"."]]],[1,"h2",[[0,[],0,"Next up, the editor"]]],[1,"p",[[0,[],0,"The main thing you'll want to read about next is probably: "],[0,[4],1,"the Ghost editor"],[0,[],0,". This is where the good stuff happens."]]],[1,"blockquote",[[0,[],0,"By the way, once you're done reading, you can simply delete the default Ghost user from your team to remove all of these introductory posts! "]]]]}

html:
  <h2 id="a-few-things-you-should-know"><strong>A few things you should know</strong></h2><ol><li>Ghost is designed for ambitious, professional publishers who want to actively build a business around their content. That's who it works best for. </li><li>The entire platform can be modified and customised to suit your needs. It's very powerful, but does require some knowledge of code. Ghost is not necessarily a good platform for beginners or people who just want a simple personal blog. </li><li>It's possible to work with all your favourite tools and apps with hundreds of <a href="https://ghost.org/integrations/">integrations</a> to speed up your workflows, connect email lists, build communities and much more.</li></ol><h2 id="behind-the-scenes">Behind the scenes</h2><p>Ghost is made by an independent non-profit organisation called the Ghost Foundation. We are 100% self funded by revenue from our <a href="https://ghost.org/pricing">Ghost(Pro)</a> service, and every penny we make is re-invested into funding further development of free, open source technology for modern publishing.</p><p>The version of Ghost you are looking at right now would not have been made possible without generous contributions from the open source <a href="https://github.com/TryGhost">community</a>.</p><h2 id="next-up-the-editor">Next up, the editor</h2><p>The main thing you'll want to read about next is probably: <a href="/the-editor/">the Ghost editor</a>. This is where the good stuff happens.</p><blockquote>By the way, once you're done reading, you can simply delete the default Ghost user from your team to remove all of these introductory posts! </blockquote>

plaintext:
  A few things you should know
   1. Ghost is designed for ambitious, professional publishers who want to
      actively build a business around their content. That's who it works best
      for. 
   2. The entire platform can be modified and customised to suit your needs. It's
      very powerful, but does require some knowledge of code. Ghost is not
      necessarily a good platform for beginners or people who just want a simple
      personal blog. 
   3. It's possible to work with all your favourite tools and apps with hundreds
      of integrations [https://ghost.org/integrations/] to speed up your
      workflows, connect email lists, build communities and much more.

  Behind the scenes
  Ghost is made by an independent non-profit organisation called the Ghost
  Foundation. We are 100% self funded by revenue from our Ghost(Pro)
  [https://ghost.org/pricing] service, and every penny we make is re-invested into
  funding further development of free, open source technology for modern
  publishing.

  The version of Ghost you are looking at right now would not have been made
  possible without generous contributions from the open source community
  [https://github.com/TryGhost].

  Next up, the editor
  The main thing you'll want to read about next is probably: the Ghost editor
  [/the-editor/]. This is where the good stuff happens.

  > By the way, once you're done reading, you can simply delete the default Ghost
  user from your team to remove all of these introductory posts!

custom_excerpt:
  Welcome, it's great to have you here.
  We know that first impressions are important, so we've populated your new site with some initial getting started posts that will help you get familiar with everything in no time.


