Skip to content

Latest commit

 

History

History
71 lines (49 loc) · 2.67 KB

seo.md

File metadata and controls

71 lines (49 loc) · 2.67 KB

Vuepress SEO: improving your search engine rankings

Reference

See See the Front matter in the official VuePress documentaton

Description shown by search engines

Search engines like to find an HTML description meta-tag on each page, and they will normally use it in search results. You can add it to a page using YAML.

Page title (text of browser tab)

The text of the first header appears in your browser tab. It's assembled from two sources:

  1. The first header on your page or as defined in the page's YAML front matter.
  2. The site title defined in config.js

They're separated using the vertical pipe character and a space on each side. So if your site is titled Awesome Guitars and page consists of

# About the Fender Performer

All geniuses agree the best guitar is the Fender Performer.
#

Then the browser tab will probably read as Awesome Guitars | About the Fender Performer. The operative phrase is "probably" because this behavior isn't specified by any standards documents.

When there's no site title defined

If you haven't created a site title in config.js the title is taken from the first header on the current page.

Favicon

Good organization makes great SEO

Both people and search engines love well-organized sites. In general:

  • Keep to one topic per page
  • The first header of the page should be an H1 (A single # starts the header) and should contain the keyphrase users are most likely to search for
  • There should be only one H1
  • Subordinate topics should be hierarchically organized, so H2 subtitles would be second-most important and H3s would be third most important

All of these principles are general and your mileage may vary. If a hugely influential Instgrammer, former US president, or FIFA star happens to mention your site online, it will rocket to the top of search at least temporarily no matter how badly it's search engine optimized.

Open source helps

If you're willing to make the source pages of your book publicly viewable on GitHub, you'll get a huge SEO booost.