In this article, I'll show you how to quickly setup pretty URLs in Super with a little shell command and a Node.js script. If you are reading this, you may already be aware that helps you go public with your pages.  What you may not know, is that ugly URLs are And notion's got some ugly URLs. https://super.so https://www.notion.so bad for SEO. It should come as no surprise that the easier a URL is to read for humans, the better it is for search engines - Rand Fishkin Well, color me surprised!  I've never needed to give SEO any thought before, but now it's my job to care!  It's time to accommodate the web crawlers and get our new and pages indexed. help careers So the first step to getting all your links pretty and into Super, is to get all the links off of your notion page.  In the case of the new Hacker Noon help page (http://help.hackernoon.com/), there were links to pretty up in this super form: 157 That's a lot of copy-pasting and clicking around and coming up with pretty URLs and so I decided to open up my chrome browser's network tab and see what was being sent to the server so I could just give it a single payload with all the links in it. DISCLAIMER:  Using any site a way not intended by the developers may result loss data.  Proceed at your own risk!  (maybe start a little test where it won in in of with 't hurt anything:) To to get the network tab, one needs to open the developer console.  On a mac, this is done with cmd+option+i.  You can also reach this by clicking the ellipsis/hamburger menu (three dots, in a column) button, going to More Tools and then finally Developer Console A portion of your window should be covered with a new panel and at the top of that, you should see some tabs.  One of those is called Network and will provide us with a template to use in our own payload to send to Super. You can see Network selected here with the blue underline.  If I click on the clear button 🚫 next to the red circle, it'll clear out any previous network calls so we can clearly see what is sent when we save our pretty URLs. Here we see a bunch of requests that happened, but the POST that goes to a URL called "update" looks interesting for our use case.  (You may need to right-click the columns to select "Method" to be able to show that column)  You can also use the search box with to filter to just those types of calls, if you already know what you are looking for. method:POST If you click on the method and look at the Headers tab that will show up, then scroll to the bottom of that, you will see the request payload. Open that up and see where the stuff you typed into the pretty URL window is. In this cast, there is a field called prettyUrls that is an array of objects with two fields, which ends up just getting the ugly, unique identifier portion of a notion URL, and also a field which is where it will redirect.  So now we know what we are doing, we need an array of objects with all our notion page ids and the URLs they are going to.  Upwards and onwards! pageId url Right-click that method and select if you want to write a node.js script like I did.  Maybe you're into curl or using fetch right in the browser's console. Copy > Copy as Node.js fetch Okay, so you've got this node code in our paste buffer and nowhere to put it!  It's time to make a script and paste it in there. We are going to ignore it for now though because I wrote this article a little out of order and I can't drag things around to reorder them and I'm just gonna roll with it! Let's move on to getting all the notion links off the page.   One way this can be done is by downloading the page and its links with: wget -r -l0 https://help.hackernoon.com/ This took a few minutes and may have been overkill, but when it was done I had a neat little help.hackernoon.com folder with a bunch of HTML files.  I ended up using the HTML files to come up with the pretty URL so maybe not overkill.  Here's a bit of what it looked like in that directory when I listed the files: help.hackernoon.com ls
0109b933c3084e9699b408a73b142e8a  5c115f8cb76445788bb16a4499758cd8  d1edc21b1f2d48d9afa43f4da6d4cc4f
0142ddfc63b94ef9a1ca01975c3d2cab  5c45cf10b99046939df336a23ddae597  d44cdbf1e6d94c0eab9fb5091c249e97
028466d28622424ca1523069faf1d7c6  5f54fe2e3b6641b3b1d49f7b47a961d7  db9dd7e7998141df9705628b03fcd75b
033557c93f714ae092e13e095ca9c2cf  604adc1e960840b782d7f2de2687f719  de55338768674dccbc80909d4ccea58f Cool, so all these piles of alpha-numeric characters are the notion entry to put in the left side of that form. To get the corresponding pretty URL to put on the right-hand side, I peeked inside one of the files and looked for where the header was by searching for h1 There it is with the juicy "Hacker Noon Editor 101" meat/text inside.  Now to start a script to iterate over all these files and parse and kebab-case the h1 headers. I used , which is jQuery for node.js, to do this.  This is how things started to look: the library cheerio fs = ( ); cheerio = ( ); { files = fs.promises.readdir( ); ( file files) { stat = fs.promises.stat(file); (stat.isDirectory()) ; html = fs.readFileSync(file).toString(); $ = cheerio.load(html); contents = $( ).contents()[ ]; (!contents) ; url = contents.data; .log(url);
  }
})(); const require "fs" const require "cheerio" ( )=> ( async const await "./" for const of const await if continue //we just want the html files const const const 'h1' 0 if continue const console So this script was run from inside that help.hackernoon.com so it could find the files easily with the path. Next, we used the function to help us determine if it was a file or directory, as there was one directory to skip. ./ stat _next Maybe you think the is whack, because it is synchronous? You are correct. readFileSync It doesn't matter though, this is just a one-off script to get the job done.  We call on that to be able to pass the wad of HTML text at cheerio and now we can run selectors on it to scrape it. toString() I needed the first h1 so our selector is simply that and we to get the first one, maybe it found more, if it didn't we continue going to the next file.  After that the schema cheerio gives you dictates that to get the text out you will need to ask for the to get the text.  All these get logged out and I could see if things were looking good. [0] .data By the way, one nice way to work on things like this and get quick feedback is to use another package https://nodemon.io/ which can be installed globally to use as a shell command or as a library to be used for your own file watching needs, like if you want to roll your own hot reloading framework for node development.  In this case, my script was called sendIt.js and so I could run in one split pane of my terminal and anytime I saved the file in another split, the file was re-run and I got a handy feedback loop. nodemon sendIt.js Okay, it's time to combine the node.js fetch bit with this loop that gets all the URL mappings. I'm going to plop in a gist now that should get the idea across.  The new code added to our existing code is just adding a Set and then adding our pretty URL objects to that. You may also notice that I am adjusting the pretty URL around line 22. It's there that we modify the h1 text by making it lowercase on line and removing invalid URL characters. Spaces become dashes, double dashes turn back into one dash, strips out the non-dashes and all non-alphanumeric characters.  Next, leading and trailing dashes are removed. /[^0-9a-z-]/gi This could be condensed into less replace calls, but this is readable and this code will only ever run when you want to update your pretty URLs so I am not going to sweat it. Next, around , I skip some files with dots because those were downloaded but don't need mappings, like index.js.  You could also just delete them from the folder of links that were downloaded. line 29 with the body was created by copying the string from the node.js fetch code we pasted in from the developer console into a node REPL and running on that.  Now it's some code, so we can get a chance to take our Set of prettyUrls and get them into our payload. will turn the Set into an array. Line 42 JSON.parse Array.from(prettyUrls) The rest of the fetch is unchanged, save for the body section where I it back into the original format we pasted in.  I save this fetch call as a variable so I can print it and see what any issues are.  There are always issues with the first (through at least the 10th) attempt. JSON.stringify In my case, the lines about stripping our invalid chars, having duplicate entries that were already added to the list of pretty URLs and all that were my issues that caused me to iterate a few times on this.  So there were more console.logs sprinkled throughout this code to help me identify where things went wrong. If the result of the fetch has a and the word OK, you are good. Refresh your pretty URL list and double-check.  If you get a 500 and a Bad Gateway, you probably sent an invalid character in the URL or sent a duplicate entry. status 200 So there you have it, you can use these ideas in a lot of other places than just notion and super.  Just be careful you try out ideas on something else first that you are not worried about screwing up if you send the wrong payload.  The saying "Measure twice, cut once" comes to mind. Anywho, I hope this was helpful.  You can tell me your thoughts about it on Twitter if you really want.  I primarily wrote this to help me get over my writer's block and just publish .  ✌️ something

How to Clean Up Notion URLs: From Ugly URLs to Pretty URLs in Minutes

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

AI Image Generation in the HackerNoon Editor (with Stable Diffusion)

10 Indications That You Should Invest in Automation Via APIs

10 Commandments for AI-Assisted Social Media Marketers

11 Best Automation Testing Tools to Try in 2021

12 Use Cases of AI and Machine Learning In Finance

AI Image Generation in the HackerNoon Editor (with Stable Diffusion)

10 Indications That You Should Invest in Automation Via APIs

10 Commandments for AI-Assisted Social Media Marketers

11 Best Automation Testing Tools to Try in 2021

12 Use Cases of AI and Machine Learning In Finance

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps